---
title: "Get"
method: GET
path: "/api/v1/apps/{app_id}/connectors/{id}"
tags: ["Connector"]
---

# Get

`GET /api/v1/apps/{app_id}/connectors/{id}`

Get a connector.

## Path parameters

- `app_id` string, required — The appId of the app the connector is attached to.
- `id` string, required — The id of the connector.

## Response `200`

The ConnectorServiceGetResponse message contains the connectorView, and an expand mask.

- C1ApiAppV1ConnectorServiceGetResponse — The ConnectorServiceGetResponse message contains the connectorView, and an expand mask.
  - `connectorView` C1ApiAppV1ConnectorView — The ConnectorView object provides a connector response object, as well as JSONPATHs to related objects provided by expanders.
    - `appPath` string — JSONPATH expression indicating the location of the App object in the expanded array.
    - `capabilitiesPath` string — JSONPATH expression indicating the location of the ConnectorCapabilities object in the expanded array.
    - `connector` C1ApiAppV1Connector — A Connector is used to sync objects into Apps
      - `appId` string — The id of the app the connector is associated with.
      - `canResumeSync` boolean — The canResumeSync field.
      - `catalogId` string — The catalogId describes which catalog entry this connector is an instance of. For example, every Okta connector will have the same catalogId indicating it is an Okta connector.
      - `config` object, nullable — Contains an arbitrary serialized message along with a @type that describes the type of the serialized message.
        - `@type` string — The type of the serialized message.
      - `configUpdatedAt` string, date-time, nullable
      - `connectorApiVersion` integer — The connectorApiVersion field.
      - `connectorSyncCronSchedule` C1ApiAppV1ConnectorSyncCronSchedule — The ConnectorSyncCronSchedule message.
        - `cronSpec` string — The cronSpec field.
        - `start` string, date-time, nullable
        - `timezone` string — The timezone field.
      - `createdAt` string, date-time, nullable
      - `deletedAt` string, date-time, nullable
      - `description` string — The description of the connector.
      - `disableCheckBadSync` boolean — The disableCheckBadSync field.
      - `displayName` string — The display name of the connector.
      - `downloadUrl` string — The downloadUrl for a spreadsheet if the connector was created from uploading a file.
      - `id` string — The id of the connector.
      - `oauthAuthorizedAs` C1ApiAppV1OAuth2AuthorizedAs — OAuth2AuthorizedAs tracks the user that OAuthed with the connector.
        - `authEmail` string — authEmail is the email of the user that authorized the connector using OAuth.
        - `authorizedAt` string, date-time, nullable
      - `parallelSyncWorkerCount` integer, nullable — Number of sync workers to use for parallel sync, when the PARALLEL_SYNC feature is enabled. Zero disables parallel sync. Optional on write: omit the field in UpdateAdvancedConfig to leave the stored value unchanged. The public API allows setting up to 4.
      - `profileAllowList` string[], nullable — List of profile attributes to sync, when set only these attributes will be synced
      - `profileIgnoreList` string[], nullable — List of profile attributes to ignore (not sync), when set other attributes will be synced, but these will not.
      - `status` C1ApiAppV1ConnectorStatus — The status field on the connector is used to track the status of the connectors sync, and when syncing last started, completed, or caused the connector to update.
        - `completedAt` string, date-time, nullable
        - `lastError` string — The last error encountered by the connector.
        - `startedAt` string, date-time, nullable
        - `status` 'SYNC_STATUS_UNSPECIFIED' | 'SYNC_STATUS_RUNNING' | 'SYNC_STATUS_DONE' | 'SYNC_STATUS_ERROR' | 'SYNC_STATUS_DISABLED' — The status of the connector sync.
        - `updatedAt` string, date-time, nullable
      - `syncConfig` C1ApiAppV1SyncConfig — The SyncConfig message.
        - `syncResourceTypeIds` string[], nullable — The syncResourceTypeIds field.
      - `syncDisabledAt` string, date-time, nullable
      - `syncDisabledCategory` string — The category of the connector sync that was disabled.
      - `syncDisabledReason` string — The reason the connector sync was disabled.
      - `updatedAt` string, date-time, nullable
      - `userIds` string[], nullable — The userIds field is used to define the integration owners of the connector.
    - `usersPath` string — JSONPATH expression indicating the location of the User object in the expanded array. This is the user that is a direct target of the ticket without a specific relationship to a potentially non-existent app user.
  - `expanded` object[], nullable — The array of expanded items indicated by the request.
    - `@type` string — The type of the serialized message.

## Changes

- **2026-08-21** `f2cf3228f366` — 2 breaking, 4 warning
  - added `#/components/schemas/c1.api.app.v1.ConnectorView, subschema #2` to the `connectorView` response property `oneOf` list for the response status `200`
  - the `connectorView` response's property type/format changed from `object`/`` to ``/`` for status `200`
  - removed the optional property `connectorView/appPath` from the response with the `200` status
  - removed the optional property `connectorView/capabilitiesPath` from the response with the `200` status
  - …2 more
- **2026-04-30** `fa2bb307d6fa` — 2 info
  - added the optional property `connectorView/connector/configUpdatedAt` to the response with the `200` status
  - added the optional property `connectorView/connector/parallelSyncWorkerCount` to the response with the `200` status
- **2026-03-10** `7fa698b04b81` — 1 info
  - added the optional property `connectorView/connector/connectorApiVersion` to the response with the `200` status
- **2026-02-05** `417c5bf9b0a2` — 1 info
  - added the optional property `connectorView/connector/connectorSyncCronSchedule` to the response with the `200` status
- **2025-11-12** `6f49a3969499` — 1 info
  - added the optional property `connectorView/connector/syncConfig` to the response with the `200` status

[Full history](https://skmtc.dev/conductorone/apis/c1-api/changes/api/v1/apps/:app_id/connectors/:id/get.md)

---

[API](https://skmtc.dev/conductorone/apis/c1-api.md) · [All operations](https://skmtc.dev/conductorone/apis/c1-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/conductorone/c1-api/revisions/f2cf3228f366/schema)