--- title: "Update" method: POST path: "/api/v1/apps/{app_id}/connectors/{id}" tags: ["Connector"] --- # Update `POST /api/v1/apps/{app_id}/connectors/{id}` Update a connector. ## Path parameters - `app_id` string, required — The id of the app the connector is associated with. - `id` string, required — The id of the connector. ## Request body - C1ApiAppV1ConnectorServiceUpdateRequestInput — The ConnectorServiceUpdateRequest message contains the fields required to update a connector. - `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. - `expandMask` C1ApiAppV1ConnectorExpandMask — The ConnectorExpandMask is used to expand related objects on a connector. - `paths` string[], nullable — Paths that you want expanded in the response. Possible values are "app_id", "user_ids", "capabilities" and "*". - `updateMask` string, nullable ## Response `200` ConnectorServiceUpdateResponse is the response returned by the update method. - C1ApiAppV1ConnectorServiceUpdateResponse — ConnectorServiceUpdateResponse is the response returned by the update method. - `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` — 5 breaking, 23 warning, 2 info - the request property `updateMask` became not nullable - the `connector` request property type/format changed from `object`/`` to ``/`` - the `expandMask` request property type/format changed from `object`/`` to ``/`` - added `#/components/schemas/c1.api.app.v1.ConnectorView, subschema #2` to the `connectorView` response property `oneOf` list for the response status `200` - …26 more - **2026-04-30** `fa2bb307d6fa` — 3 info - added the new optional request property `connector/parallelSyncWorkerCount` - 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` — 2 info - added the new optional request property `connector/connectorSyncCronSchedule` - added the optional property `connectorView/connector/connectorSyncCronSchedule` to the response with the `200` status - **2025-11-12** `6f49a3969499` — 2 info - added the new optional request property `connector/syncConfig` - 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/post.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)