Manually Sync Integration

If sync_enabled is true, the Integration will automatically sync based on the workspace sync schedule configured in HQ. If sync_enabled is false or you need to perform a sync sooner than the next scheduled sync, you can dispatch a sync job immediately using this endpoint.

POST /workspace/integrations/{integration}/sync

Manually Sync Integration

cURL

curl --request POST \
  --url https://wks-a1b2c3d4.provisionr.io/api/v1/workspace/integrations/{integration}/sync \
  --header 'Authorization: Bearer <token>'

202

{
  "id": "<string>",
  "is_primary": true,
  "vendor": "<string>",
  "name": "<string>",
  "handle": "<string>",
  "domain": "<string>",
  "manager_enabled": true,
  "manager_id_child_key": "<string>",
  "manager_id_parent_key": "<string>",
  "retention_days": 123,
  "sync_enabled": true,
  "metadata": {},
  "timestamp": {
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z",
    "deleted_at": "2023-11-07T05:31:56Z",
    "synced_at": "2023-11-07T05:31:56Z"
  },
  "count": {
    "directory_attributes": 123,
    "directory_dimensions": 123,
    "directory_identities": 123,
    "policy_conditions": 123,
    "workspace_logs_parent": 123,
    "workspace_logs_record": 123,
    "workspace_logs_related": 123
  },
  "links": {
    "self": "<string>",
    "directory_attributes": "<string>",
    "directory_dimensions": "<string>",
    "directory_identities": "<string>",
    "policy_conditions": "<string>",
    "workspace_logs_parent": "<string>",
    "workspace_logs_record": "<string>",
    "workspace_logs_related": "<string>"
  }
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

integration · string · required

Workspace Integration ID

Response

202

application/json

WorkspaceIntegrationDetailedResponseData

id · string · required

Example:

"wsitg_01hq8xyzabc123def456ghi789"

is_primary · boolean · required

Whether this is the primary identity integration for the workspace

vendor · string · required

The vendor of the identity integration

Example:

"okta"

name · string · required

The display name of the identity integration

Example:

"Okta"

handle · string · required

The handle of the identity integration

Example:

"okta-prod"

domain · string | null · required

The domain of the identity integration

Example:

"example.okta.com"

manager_enabled · boolean · required

Whether manager hierarchy is enabled for this integration

manager_id_child_key · string | null · required

The field name in the integration data that contains the manager ID

Example:

"managerId"

manager_id_parent_key · string | null · required

The field name in the target data where the manager ID should be stored

Example:

"manager_id"

retention_days · integer · required

The number of days to retain synced data

Example:

90

sync_enabled · boolean · required

Whether automatic syncing is enabled

metadata · object · required

The integration's custom key/value metadata added by someone or automation in your organization

Show child attributes

Example:

{
  "managed_by": "Identity Team",
  "security_classification": "red"
}

timestamp · WorkspaceIntegrationTimestampResponseData · object · required

The timestamps for the workspace integration record

Show child attributes

count · object · required

Counts of related resources

Show child attributes

links · object · required

API hyperlinks related to the workspace integration record

Show child attributes