SCIM 2.0

SCIM 2.0 service provider for user and group provisioning from your identity provider.

Конфігурація служби SCIM

GET /scim/v2/ServiceProviderConfig

Автентифікація: Немає: запит автентифікується підписом, описаним вище.

Відповіді

Статус	Опис
`200`	Capabilities of the SCIM service.

Приклад 200

{
  "schemas": [
    "urn:ietf:params:scim:schemas:core:2.0:ServiceProviderConfig"
  ],
  "patch": {
    "supported": true
  },
  "bulk": {
    "supported": false,
    "maxOperations": 0,
    "maxPayloadSize": 0
  },
  "filter": {
    "supported": true,
    "maxResults": 200
  },
  "changePassword": {
    "supported": false
  },
  "sort": {
    "supported": true
  },
  "etag": {
    "supported": false
  },
  "authenticationSchemes": [
    {
      "type": "oauthbearertoken",
      "name": "OAuth Bearer Token",
      "primary": true
    }
  ]
}

Приклад із curl

curl -X GET "https://exocortex-api.ai-exo-cortex.com/scim/v2/ServiceProviderConfig"

Типи ресурсів SCIM

GET /scim/v2/ResourceTypes

Автентифікація: Немає: запит автентифікується підписом, описаним вище.

Відповіді

Статус	Опис
`200`	Supported resource types (User, Group).

Приклад 200

{
  "schemas": [
    "urn:ietf:params:scim:api:messages:2.0:ListResponse"
  ],
  "totalResults": 2,
  "Resources": [
    {
      "id": "User",
      "name": "User",
      "endpoint": "/Users",
      "schema": "urn:ietf:params:scim:schemas:core:2.0:User"
    },
    {
      "id": "Group",
      "name": "Group",
      "endpoint": "/Groups",
      "schema": "urn:ietf:params:scim:schemas:core:2.0:Group"
    }
  ]
}

Приклад із curl

curl -X GET "https://exocortex-api.ai-exo-cortex.com/scim/v2/ResourceTypes"

Схеми SCIM

GET /scim/v2/Schemas

Автентифікація: Немає: запит автентифікується підписом, описаним вище.

Відповіді

Статус	Опис
`200`	Supported schemas.

Приклад 200

{
  "schemas": [
    "urn:ietf:params:scim:api:messages:2.0:ListResponse"
  ],
  "totalResults": 2,
  "Resources": [
    {
      "id": "urn:ietf:params:scim:schemas:core:2.0:User",
      "name": "User",
      "description": "User Account"
    },
    {
      "id": "urn:ietf:params:scim:schemas:core:2.0:Group",
      "name": "Group",
      "description": "Group"
    }
  ]
}

Приклад із curl

curl -X GET "https://exocortex-api.ai-exo-cortex.com/scim/v2/Schemas"

Список користувачів

GET /scim/v2/Users

Автентифікація: Токен SCIM: Authorization: Bearer <token>

Параметри

Назва	Де	Тип	Обов’язковий	Опис
`filter`	query	string	ні	SCIM filter, for example `userName eq "[email protected]"`. `and` is supported.
`startIndex`	query	integer	ні
`count`	query	integer	ні

Відповіді

Статус	Опис
`200`	Users of the token’s tenant.
`401`	SCIM token missing, invalid, revoked or expired.

Приклад 200

{
  "schemas": [
    "urn:ietf:params:scim:api:messages:2.0:ListResponse"
  ],
  "totalResults": 1,
  "startIndex": 1,
  "itemsPerPage": 1,
  "Resources": [
    {
      "schemas": [
        "urn:ietf:params:scim:schemas:core:2.0:User"
      ],
      "id": "[email protected]",
      "userName": "[email protected]",
      "name": {
        "givenName": "Jane",
        "familyName": "Doe",
        "formatted": "Jane Doe"
      },
      "displayName": "Jane Doe",
      "emails": [
        {
          "value": "[email protected]",
          "type": "work",
          "primary": true
        }
      ],
      "active": true,
      "meta": {
        "resourceType": "User",
        "location": "/scim/v2/Users/[email protected]"
      }
    }
  ]
}

Приклад із curl

curl -X GET "https://exocortex-api.ai-exo-cortex.com/scim/v2/Users" \
  -H "Authorization: Bearer $EXO_SCIM_TOKEN"

Створити користувача

POST /scim/v2/Users

Автентифікація: Токен SCIM: Authorization: Bearer <token>

Тіло запиту

application/scim+json

Назва	Тип	Обов’язковий	Опис
`schemas`	array<string>	так
`id`	string	ні
`externalId`	string \	null	ні
`userName`	string	так
`name`	object	ні
`name.givenName`	string	ні
`name.familyName`	string	ні
`name.formatted`	string	ні
`displayName`	string	ні
`emails`	array<object>	ні
`emails[].value`	string (email)	ні
`emails[].type`	string	ні
`emails[].primary`	boolean	ні
`active`	boolean	ні
`userType`	string	ні
`title`	string \	null	ні
`locale`	string \	null	ні
`timezone`	string \	null	ні
`urn:ietf:params:scim:schemas:extension:enterprise:2.0:User`	object	ні
`urn:ietf:params:scim:schemas:extension:enterprise:2.0:User.employeeNumber`	string \	null	ні
`urn:ietf:params:scim:schemas:extension:enterprise:2.0:User.department`	string \	null	ні
`urn:ietf:params:scim:schemas:extension:enterprise:2.0:User.manager`	object \	null	ні
`meta`	object	ні
`meta.resourceType`	string	ні
`meta.created`	string \	null (date-time)	ні
`meta.lastModified`	string \	null (date-time)	ні
`meta.location`	string	ні

{
  "schemas": [
    "urn:ietf:params:scim:schemas:core:2.0:User"
  ],
  "userName": "[email protected]",
  "externalId": "00u1a2b3c4D5e6F7g8h9",
  "name": {
    "givenName": "Jane",
    "familyName": "Doe"
  },
  "emails": [
    {
      "value": "[email protected]",
      "type": "work",
      "primary": true
    }
  ],
  "active": true
}

Відповіді

Статус	Опис
`201`	User created.
`400`	Invalid SCIM request.
`401`	SCIM token missing, invalid, revoked or expired.
`409`	A user with this `userName` already exists.

Приклад 201

{
  "schemas": [
    "urn:ietf:params:scim:schemas:core:2.0:User"
  ],
  "id": "[email protected]",
  "externalId": "00u1a2b3c4D5e6F7g8h9",
  "userName": "[email protected]",
  "name": {
    "givenName": "Jane",
    "familyName": "Doe",
    "formatted": "Jane Doe"
  },
  "displayName": "Jane Doe",
  "emails": [
    {
      "value": "[email protected]",
      "type": "work",
      "primary": true
    }
  ],
  "active": true,
  "userType": "User",
  "urn:ietf:params:scim:schemas:extension:enterprise:2.0:User": {
    "employeeNumber": "E-10442",
    "department": "Finance",
    "manager": null
  },
  "meta": {
    "resourceType": "User",
    "created": "2026-11-01T08:00:00.000Z",
    "lastModified": "2026-11-01T08:00:00.000Z",
    "location": "/scim/v2/Users/[email protected]"
  }
}

Приклад із curl

curl -X POST "https://exocortex-api.ai-exo-cortex.com/scim/v2/Users" \
  -H "Authorization: Bearer $EXO_SCIM_TOKEN" \
  -H "Content-Type: application/scim+json" \
  --data '{"schemas":["urn:ietf:params:scim:schemas:core:2.0:User"],"userName":"[email protected]","externalId":"00u1a2b3c4D5e6F7g8h9","name":{"givenName":"Jane","familyName":"Doe"},"emails":[{"value":"[email protected]","type":"work","primary":true}],"active":true}'

Отримати користувача

GET /scim/v2/Users/{id}

Автентифікація: Токен SCIM: Authorization: Bearer <token>

Параметри

Назва	Де	Тип	Обов’язковий	Опис
`id`	шлях	string	так

Відповіді

Статус	Опис
`200`	User.
`401`	SCIM token missing, invalid, revoked or expired.
`404`	Resource not found in the token’s tenant.

Приклад 200

{
  "schemas": [
    "urn:ietf:params:scim:schemas:core:2.0:User"
  ],
  "id": "[email protected]",
  "externalId": "00u1a2b3c4D5e6F7g8h9",
  "userName": "[email protected]",
  "name": {
    "givenName": "Jane",
    "familyName": "Doe",
    "formatted": "Jane Doe"
  },
  "displayName": "Jane Doe",
  "emails": [
    {
      "value": "[email protected]",
      "type": "work",
      "primary": true
    }
  ],
  "active": true,
  "userType": "User",
  "urn:ietf:params:scim:schemas:extension:enterprise:2.0:User": {
    "employeeNumber": "E-10442",
    "department": "Finance",
    "manager": null
  },
  "meta": {
    "resourceType": "User",
    "created": "2026-11-01T08:00:00.000Z",
    "lastModified": "2026-11-01T08:00:00.000Z",
    "location": "/scim/v2/Users/[email protected]"
  }
}

Приклад із curl

curl -X GET "https://exocortex-api.ai-exo-cortex.com/scim/v2/Users/[email protected]" \
  -H "Authorization: Bearer $EXO_SCIM_TOKEN"

Замінити користувача

PUT /scim/v2/Users/{id}

Автентифікація: Токен SCIM: Authorization: Bearer <token>

Параметри

Назва	Де	Тип	Обов’язковий	Опис
`id`	шлях	string	так

Тіло запиту

application/scim+json

Назва	Тип	Обов’язковий	Опис
`schemas`	array<string>	так
`id`	string	ні
`externalId`	string \	null	ні
`userName`	string	так
`name`	object	ні
`name.givenName`	string	ні
`name.familyName`	string	ні
`name.formatted`	string	ні
`displayName`	string	ні
`emails`	array<object>	ні
`emails[].value`	string (email)	ні
`emails[].type`	string	ні
`emails[].primary`	boolean	ні
`active`	boolean	ні
`userType`	string	ні
`title`	string \	null	ні
`locale`	string \	null	ні
`timezone`	string \	null	ні
`urn:ietf:params:scim:schemas:extension:enterprise:2.0:User`	object	ні
`urn:ietf:params:scim:schemas:extension:enterprise:2.0:User.employeeNumber`	string \	null	ні
`urn:ietf:params:scim:schemas:extension:enterprise:2.0:User.department`	string \	null	ні
`urn:ietf:params:scim:schemas:extension:enterprise:2.0:User.manager`	object \	null	ні
`meta`	object	ні
`meta.resourceType`	string	ні
`meta.created`	string \	null (date-time)	ні
`meta.lastModified`	string \	null (date-time)	ні
`meta.location`	string	ні

{
  "schemas": [
    "urn:ietf:params:scim:schemas:core:2.0:User"
  ],
  "id": "[email protected]",
  "externalId": "00u1a2b3c4D5e6F7g8h9",
  "userName": "[email protected]",
  "name": {
    "givenName": "Jane",
    "familyName": "Doe",
    "formatted": "Jane Doe"
  },
  "displayName": "Jane Doe",
  "emails": [
    {
      "value": "[email protected]",
      "type": "work",
      "primary": true
    }
  ],
  "active": true,
  "userType": "User",
  "urn:ietf:params:scim:schemas:extension:enterprise:2.0:User": {
    "employeeNumber": "E-10442",
    "department": "Finance",
    "manager": null
  },
  "meta": {
    "resourceType": "User",
    "created": "2026-11-01T08:00:00.000Z",
    "lastModified": "2026-11-01T08:00:00.000Z",
    "location": "/scim/v2/Users/[email protected]"
  }
}

Відповіді

Статус	Опис
`200`	User replaced.
`401`	SCIM token missing, invalid, revoked or expired.
`404`	Resource not found in the token’s tenant.

Приклад 200

{
  "schemas": [
    "urn:ietf:params:scim:schemas:core:2.0:User"
  ],
  "id": "[email protected]",
  "externalId": "00u1a2b3c4D5e6F7g8h9",
  "userName": "[email protected]",
  "name": {
    "givenName": "Jane",
    "familyName": "Doe",
    "formatted": "Jane Doe"
  },
  "displayName": "Jane Doe",
  "emails": [
    {
      "value": "[email protected]",
      "type": "work",
      "primary": true
    }
  ],
  "active": true,
  "userType": "User",
  "urn:ietf:params:scim:schemas:extension:enterprise:2.0:User": {
    "employeeNumber": "E-10442",
    "department": "Finance",
    "manager": null
  },
  "meta": {
    "resourceType": "User",
    "created": "2026-11-01T08:00:00.000Z",
    "lastModified": "2026-11-01T08:00:00.000Z",
    "location": "/scim/v2/Users/[email protected]"
  }
}

Приклад із curl

curl -X PUT "https://exocortex-api.ai-exo-cortex.com/scim/v2/Users/[email protected]" \
  -H "Authorization: Bearer $EXO_SCIM_TOKEN" \
  -H "Content-Type: application/scim+json" \
  --data '{"schemas":["urn:ietf:params:scim:schemas:core:2.0:User"],"id":"[email protected]","externalId":"00u1a2b3c4D5e6F7g8h9","userName":"[email protected]","name":{"givenName":"Jane","familyName":"Doe","formatted":"Jane Doe"},"displayName":"Jane Doe","emails":[{"value":"[email protected]","type":"work","primary":true}],"active":true,"userType":"User","urn:ietf:params:scim:schemas:extension:enterprise:2.0:User":{"employeeNumber":"E-10442","department":"Finance","manager":null},"meta":{"resourceType":"User","created":"2026-11-01T08:00:00.000Z","lastModified":"2026-11-01T08:00:00.000Z","location":"/scim/v2/Users/[email protected]"}}'

Змінити користувача (PATCH)

PATCH /scim/v2/Users/{id}

Supports add, replace and remove operations, for example deactivating with {"op":"replace","path":"active","value":false}.

Автентифікація: Токен SCIM: Authorization: Bearer <token>

Параметри

Назва	Де	Тип	Обов’язковий	Опис
`id`	шлях	string	так

Тіло запиту

application/scim+json

Назва	Тип	Обов’язковий
`schemas`	array<string>	ні
`Operations`	array<object>	так
`Operations[].op`	string (`add`, `replace`, `remove`, `Add`, `Replace`, `Remove`)	так
`Operations[].path`	string	ні
`Operations[].value`		ні

{
  "schemas": [
    "urn:ietf:params:scim:api:messages:2.0:PatchOp"
  ],
  "Operations": [
    {
      "op": "replace",
      "path": "active",
      "value": false
    }
  ]
}

Відповіді

Статус	Опис
`200`	User updated.
`400`	Invalid SCIM request.
`401`	SCIM token missing, invalid, revoked or expired.
`404`	Resource not found in the token’s tenant.

Приклад 200

{
  "schemas": [
    "urn:ietf:params:scim:schemas:core:2.0:User"
  ],
  "id": "[email protected]",
  "externalId": "00u1a2b3c4D5e6F7g8h9",
  "userName": "[email protected]",
  "name": {
    "givenName": "Jane",
    "familyName": "Doe",
    "formatted": "Jane Doe"
  },
  "displayName": "Jane Doe",
  "emails": [
    {
      "value": "[email protected]",
      "type": "work",
      "primary": true
    }
  ],
  "active": true,
  "userType": "User",
  "urn:ietf:params:scim:schemas:extension:enterprise:2.0:User": {
    "employeeNumber": "E-10442",
    "department": "Finance",
    "manager": null
  },
  "meta": {
    "resourceType": "User",
    "created": "2026-11-01T08:00:00.000Z",
    "lastModified": "2026-11-01T08:00:00.000Z",
    "location": "/scim/v2/Users/[email protected]"
  }
}

Приклад із curl

curl -X PATCH "https://exocortex-api.ai-exo-cortex.com/scim/v2/Users/[email protected]" \
  -H "Authorization: Bearer $EXO_SCIM_TOKEN" \
  -H "Content-Type: application/scim+json" \
  --data '{"schemas":["urn:ietf:params:scim:api:messages:2.0:PatchOp"],"Operations":[{"op":"replace","path":"active","value":false}]}'

Видалити користувача (депровізіонування)

DELETE /scim/v2/Users/{id}

Автентифікація: Токен SCIM: Authorization: Bearer <token>

Параметри

Назва	Де	Тип	Обов’язковий	Опис
`id`	шлях	string	так

Відповіді

Статус	Опис
`204`	User deprovisioned.
`401`	SCIM token missing, invalid, revoked or expired.
`404`	Resource not found in the token’s tenant.

Приклад із curl

curl -X DELETE "https://exocortex-api.ai-exo-cortex.com/scim/v2/Users/[email protected]" \
  -H "Authorization: Bearer $EXO_SCIM_TOKEN"

Список груп

GET /scim/v2/Groups

Автентифікація: Токен SCIM: Authorization: Bearer <token>

Параметри

Назва	Де	Тип	Обов’язковий	Опис
`filter`	query	string	ні	SCIM filter, for example `userName eq "[email protected]"`. `and` is supported.
`startIndex`	query	integer	ні
`count`	query	integer	ні

Відповіді

Статус	Опис
`200`	Groups of the token’s tenant.
`401`	SCIM token missing, invalid, revoked or expired.

Приклад 200

{
  "schemas": [
    "urn:ietf:params:scim:api:messages:2.0:ListResponse"
  ],
  "totalResults": 1,
  "startIndex": 1,
  "itemsPerPage": 1,
  "Resources": [
    {
      "schemas": [
        "urn:ietf:params:scim:schemas:core:2.0:Group"
      ],
      "id": "grp_service_desk_l1",
      "displayName": "Service Desk L1",
      "members": [
        {
          "value": "[email protected]",
          "type": "User",
          "display": "[email protected]"
        }
      ],
      "meta": {
        "resourceType": "Group",
        "location": "/scim/v2/Groups/grp_service_desk_l1"
      }
    }
  ]
}

Приклад із curl

curl -X GET "https://exocortex-api.ai-exo-cortex.com/scim/v2/Groups" \
  -H "Authorization: Bearer $EXO_SCIM_TOKEN"

Створити групу

POST /scim/v2/Groups

Автентифікація: Токен SCIM: Authorization: Bearer <token>

Тіло запиту

application/scim+json

Назва	Тип	Обов’язковий	Опис
`schemas`	array<string>	так
`id`	string	ні
`displayName`	string	так
`externalId`	string \	null	ні
`members`	array<object>	ні
`members[].value`	string	так
`members[].type`	string	ні
`members[].display`	string	ні
`meta`	object	ні
`meta.resourceType`	string	ні
`meta.created`	string \	null (date-time)	ні
`meta.lastModified`	string \	null (date-time)	ні
`meta.location`	string	ні

{
  "schemas": [
    "urn:ietf:params:scim:schemas:core:2.0:Group"
  ],
  "displayName": "Service Desk L1",
  "members": [
    {
      "value": "[email protected]"
    }
  ]
}

Відповіді

Статус	Опис
`201`	Group created.
`400`	Invalid SCIM request.
`401`	SCIM token missing, invalid, revoked or expired.

Приклад 201

{
  "schemas": [
    "urn:ietf:params:scim:schemas:core:2.0:Group"
  ],
  "id": "grp_service_desk_l1",
  "displayName": "Service Desk L1",
  "externalId": null,
  "members": [
    {
      "value": "[email protected]",
      "type": "User",
      "display": "[email protected]"
    }
  ],
  "meta": {
    "resourceType": "Group",
    "created": "2026-11-01T08:00:00.000Z",
    "lastModified": "2026-11-01T08:00:00.000Z",
    "location": "/scim/v2/Groups/grp_service_desk_l1"
  }
}

Приклад із curl

curl -X POST "https://exocortex-api.ai-exo-cortex.com/scim/v2/Groups" \
  -H "Authorization: Bearer $EXO_SCIM_TOKEN" \
  -H "Content-Type: application/scim+json" \
  --data '{"schemas":["urn:ietf:params:scim:schemas:core:2.0:Group"],"displayName":"Service Desk L1","members":[{"value":"[email protected]"}]}'

Отримати групу

GET /scim/v2/Groups/{id}

Автентифікація: Токен SCIM: Authorization: Bearer <token>

Параметри

Назва	Де	Тип	Обов’язковий	Опис
`id`	шлях	string	так

Відповіді

Статус	Опис
`200`	Group.
`401`	SCIM token missing, invalid, revoked or expired.
`404`	Resource not found in the token’s tenant.

Приклад 200

{
  "schemas": [
    "urn:ietf:params:scim:schemas:core:2.0:Group"
  ],
  "id": "grp_service_desk_l1",
  "displayName": "Service Desk L1",
  "externalId": null,
  "members": [
    {
      "value": "[email protected]",
      "type": "User",
      "display": "[email protected]"
    }
  ],
  "meta": {
    "resourceType": "Group",
    "created": "2026-11-01T08:00:00.000Z",
    "lastModified": "2026-11-01T08:00:00.000Z",
    "location": "/scim/v2/Groups/grp_service_desk_l1"
  }
}

Приклад із curl

curl -X GET "https://exocortex-api.ai-exo-cortex.com/scim/v2/Groups/[email protected]" \
  -H "Authorization: Bearer $EXO_SCIM_TOKEN"

Змінити групу (PATCH)

PATCH /scim/v2/Groups/{id}

Автентифікація: Токен SCIM: Authorization: Bearer <token>

Параметри

Назва	Де	Тип	Обов’язковий	Опис
`id`	шлях	string	так

Тіло запиту

application/scim+json

Назва	Тип	Обов’язковий
`schemas`	array<string>	ні
`Operations`	array<object>	так
`Operations[].op`	string (`add`, `replace`, `remove`, `Add`, `Replace`, `Remove`)	так
`Operations[].path`	string	ні
`Operations[].value`		ні

{
  "schemas": [
    "urn:ietf:params:scim:api:messages:2.0:PatchOp"
  ],
  "Operations": [
    {
      "op": "add",
      "path": "members",
      "value": [
        {
          "value": "[email protected]"
        }
      ]
    }
  ]
}

Відповіді

Статус	Опис
`200`	Group updated.
`400`	Invalid SCIM request.
`401`	SCIM token missing, invalid, revoked or expired.
`404`	Resource not found in the token’s tenant.

Приклад 200

{
  "schemas": [
    "urn:ietf:params:scim:schemas:core:2.0:Group"
  ],
  "id": "grp_service_desk_l1",
  "displayName": "Service Desk L1",
  "externalId": null,
  "members": [
    {
      "value": "[email protected]",
      "type": "User",
      "display": "[email protected]"
    }
  ],
  "meta": {
    "resourceType": "Group",
    "created": "2026-11-01T08:00:00.000Z",
    "lastModified": "2026-11-01T08:00:00.000Z",
    "location": "/scim/v2/Groups/grp_service_desk_l1"
  }
}

Приклад із curl

curl -X PATCH "https://exocortex-api.ai-exo-cortex.com/scim/v2/Groups/[email protected]" \
  -H "Authorization: Bearer $EXO_SCIM_TOKEN" \
  -H "Content-Type: application/scim+json" \
  --data '{"schemas":["urn:ietf:params:scim:api:messages:2.0:PatchOp"],"Operations":[{"op":"add","path":"members","value":[{"value":"[email protected]"}]}]}'

Видалити групу

DELETE /scim/v2/Groups/{id}

Автентифікація: Токен SCIM: Authorization: Bearer <token>

Параметри

Назва	Де	Тип	Обов’язковий	Опис
`id`	шлях	string	так

Відповіді

Статус	Опис
`204`	Group deleted.
`401`	SCIM token missing, invalid, revoked or expired.
`404`	Resource not found in the token’s tenant.

Приклад із curl

curl -X DELETE "https://exocortex-api.ai-exo-cortex.com/scim/v2/Groups/[email protected]" \
  -H "Authorization: Bearer $EXO_SCIM_TOKEN"

Сторінку згенеровано зі специфікації OpenAPI API інтеграції, версія 1.1.0.