• Get SCIM identities for a group
• Get a single SCIM identity
• Update extern_uid field for a SCIM identity
• Delete a single SCIM identity

SCIM API

The GitLab SCIM API manages SCIM identities within groups and provides the /Users endpoint. The base URL is /api/scim/v2/groups/:group_path/Users/.

To use this API, Group SSO must be enabled for the group. This API is only in use where SCIM for Group SSO is enabled. It’s a prerequisite to the creation of SCIM identities.

This API is different to the internal group SCIM API and the instance SCIM API:

• This API:
  • Does not implement the RFC7644 protocol.
  • Gets, checks, updates, and deletes SCIM identities within groups.
• The internal group and instance SCIM APIs:
  • Are for system use for SCIM provider integration.
  • Implement the RFC7644 protocol.
  • Get a list of SCIM provisioned users for the group or instance.
  • Create, delete and update SCIM provisioned users for the group or instance.

Get SCIM identities for a group

GET /groups/:id/scim/identities

Supported attributes:

If successful, returns 200 and the following response attributes:

Example response:

[
    {
        "extern_uid": "4",
        "user_id": 48,
        "active": true
    }
]

Example request:

curl --location --request GET "https://gitlab.example.com/api/v4/groups/33/scim/identities" \
--header "PRIVATE-TOKEN: <PRIVATE-TOKEN>"

Get a single SCIM identity

GET /groups/:id/scim/:uid

Supported attributes:

Example request:

curl --location --request GET "https://gitlab.example.com/api/v4/groups/33/scim/sydney_jones" --header "PRIVATE-TOKEN: <PRIVATE TOKEN>"

Example response:

{
    "extern_uid": "4",
    "user_id": 48,
    "active": true
}

Update extern_uid field for a SCIM identity

Fields that can be updated are:

PATCH /groups/:groups_id/scim/:uid

Parameters:

Example request:

curl --location --request PATCH "https://gitlab.example.com/api/v4/groups/33/scim/sydney_jones" \
--header "PRIVATE-TOKEN: <PRIVATE TOKEN>" \
--form "extern_uid=sydney_jones_new"

Delete a single SCIM identity

DELETE /groups/:id/scim/:uid

Supported attributes:

Example request:

curl --request DELETE --header "Content-Type: application/json" --header "Authorization: Bearer <your_access_token>" "https://gitlab.example.com/api/v4/groups/33/scim/sydney_jones"

Example response:

{
    "message" : "204 No Content"
}