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

# List

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

List connectors for an app.

## Path parameters

- `app_id` string, required — The appId field.

## Query parameters

- `page_size` integer — The pageSize field.
- `page_token` string — The pageToken field.

## Response `200`

The ConnectorServiceListResponse message contains a list of results and a nextPageToken if applicable

- C1ApiAppV1ConnectorServiceListResponse — The ConnectorServiceListResponse message contains a list of results and a nextPageToken if applicable
  - `expanded` object[], nullable — List of serialized related objects
    - `@type` string — The type of the serialized message.
  - `list` C1ApiAppV1ConnectorView[], nullable — The list of results containing up to X results, where X is the page size defined in the request
    - `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.
  - `nextPageToken` string — The nextPageToken is shown for the next page if the number of results is larger than the max page size. The server returns one page of results and the nextPageToken until all results are retreived. To retrieve the next page, use the same request and append a pageToken field with the value of nextPageToken shown on the previous page.

## Changes

- **2026-08-21** `f2cf3228f366` — 2 breaking, 25 warning
  - added `#/components/schemas/c1.api.app.v1.Connector, subschema #2` to the `list/items/connector` response property `oneOf` list for the response status `200`
  - the `list/items/connector` response's property type/format changed from `object`/`` to ``/`` for status `200`
  - removed the optional property `list/items/connector/appId` from the response with the `200` status
  - removed the optional property `list/items/connector/canResumeSync` from the response with the `200` status
  - …23 more
- **2026-04-30** `fa2bb307d6fa` — 2 info
  - added the optional property `list/items/connector/configUpdatedAt` to the response with the `200` status
  - added the optional property `list/items/connector/parallelSyncWorkerCount` to the response with the `200` status
- **2026-03-10** `7fa698b04b81` — 1 info
  - added the optional property `list/items/connector/connectorApiVersion` to the response with the `200` status
- **2026-02-05** `417c5bf9b0a2` — 1 info
  - added the optional property `list/items/connector/connectorSyncCronSchedule` to the response with the `200` status
- **2025-11-12** `6f49a3969499` — 1 info
  - added the optional property `list/items/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/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)