API reference

Operator - Identity

One tag: method, path, summary, auth, and scopes. Request and response fields ship in this page — expand a row to read the contract.

Browse docs

Endpoints

GET

/api/v1/operator/scim_events Web Session

List SCIM sync events

Description

Returns recent SCIM provisioning events for the current workspace, newest first. Browser session + CSRF only; machine Bearer tokens (including tokens with identity scopes) are 401 "An authenticated operator session is required." `limit` defaults to 50 and is clamped to 1..200. Logged `event_type` values are `user.upsert`, `user.update`, `user.patch`, `user.deprovision`, `group.upsert`, `group.update`, `group.patch`, and `group.delete`. Mint and revoke SCIM bearer tokens on Workspace admin (`/app/admin`), not `/app/workspace`.

Auth

Web Session

Parameters

Name	In	Type	Required	Description
limit	query	integer	No	Maximum events to return (default 50, maximum 200). Invalid values use 50.

Responses

200

Recent SCIM sync events

Response Body

Field	Type	Required	Description
scim_sync_events	array<object>	Yes	SCIM sync events
scim_sync_events[].id	string	Yes	Event UUID
scim_sync_events[].status	string	Yes	success or error
scim_sync_events[].request_id	string	No	Correlated HTTP request id
scim_sync_events[].error_message	string	No	Failure detail when status is error
scim_sync_events[].inserted_at	datetime (ISO 8601)	Yes	Created at
scim_sync_events[].updated_at	datetime (ISO 8601)	Yes	Updated at
scim_sync_events[].event_type	string (user.upsert, user.update, user.patch, user.deprovision, group.upsert, group.update, group.patch, group.delete)	Yes	Provisioning event
scim_sync_events[].external_id	string	No	IdP externalId
scim_sync_events[].scim_resource_id	string	No	User or group UUID when known
scim_sync_events[].scim_resource_type	string (User, Group)	No	SCIM resource type

Example

{
  "scim_sync_events": [
    {
      "error_message": null,
      "event_type": "user.upsert",
      "external_id": "ext-user-001",
      "id": "3a1b2c4d-5678-4e9f-a012-3456789abcde",
      "inserted_at": "2026-03-27T09:12:10Z",
      "request_id": "req_2f91c4a8",
      "scim_resource_id": "0f1cdac9-305d-4d11-a53d-3fca310c0635",
      "scim_resource_type": "User",
      "status": "success",
      "updated_at": "2026-03-27T09:12:10Z"
    }
  ]
}

401

No operator browser session