---
title: "Get connector specs"
method: GET
path: "/api/{workspaceId}/sources/spec"
tags: ["Syncs"]
---

# Get connector specs

`GET /api/{workspaceId}/sources/spec`

## Request

- Base URL: `https://use.jitsu.com`
- URL: `https://use.jitsu.com/api/{workspaceId}/sources/spec`
- Auth: HTTP bearer

Returns the JSON schema describing a connector package's credentials/config form. First call kicks off an async fetch from the sync controller and returns `{ ok: false, pending: true }`; poll until `ok: true` and `specs` is populated. Pass `force=true` to bypass the cache.

## Path parameters

- `workspaceId` string, required

## Query parameters

- `package` string, required
- `version` string, required
- `force` string

## Response `200`

OK

- object
  - `ok` boolean, required
  - `pending` boolean
  - `error` string
  - `specs` object
  - `startedAt` number

## Other responses

- `400`: Bad request
- `401`: Authorization required
- `403`: Forbidden — no access to this workspace, or the workspace's plan does not include this feature
- `500`: Internal server error

---

[API](https://skmtc.dev/jitsu/apis/jitsu-api.md) - [All operations](https://skmtc.dev/jitsu/apis/jitsu-api/llms.txt) - [OpenAPI document](https://skmtc.dev/jitsu/apis/jitsu-api/revisions/f6b8702d246f?raw)