Skip to content
  • Auto
  • Light
  • Dark
Get Started

Retrieve

Get
get/api/v1/apps/{app_id}/connectors/{id}

Get a connector.

Path Parameters
app_idstring

The appId of the app the connector is attached to.

idstring

The id of the connector.

Returns
connectorViewappPathstringconnectorC1APIAppV1ConnectorusersPathstringC1APIAppV1ConnectorView
optional

The ConnectorView object provides a connector response object, as well as JSONPATHs to related objects provided by expanders.

expandedarray of object
optional

The array of expanded items indicated by the request.

Hide ParametersShow Parameters
@typestring
optional

The type of the serialized message.

Request example cURL
curl https://{tenantDomain}.conductor.one/api/v1/apps/$APP_ID/connectors/$ID \
    -H "Authorization: Bearer $CONDUCTORONE_SDK_API_KEY"
200 Example
{
  "connectorView": {
    "appPath": "appPath",
    "connector": {
      "id": "id",
      "appId": "appId",
      "catalogId": "catalogId",
      "config": {
        "@type": "@type"
      },
      "description": "description",
      "displayName": "displayName",
      "oauthAuthorizedAs": {},
      "profileAllowList": [
        "string"
      ],
      "profileIgnoreList": [
        "string"
      ],
      "status": {
        "completedAt": "2019-12-27T18:11:19.117Z",
        "lastError": "lastError",
        "startedAt": "2019-12-27T18:11:19.117Z",
        "status": "SYNC_STATUS_UNSPECIFIED",
        "updatedAt": "2019-12-27T18:11:19.117Z"
      },
      "syncDisabledCategory": "syncDisabledCategory",
      "syncDisabledReason": "syncDisabledReason",
      "userIds": [
        "string"
      ]
    },
    "usersPath": "usersPath"
  },
  "expanded": [
    {
      "@type": "@type"
    }
  ]
}