Sign in

v14

latestOpenAPI 3.1.02026-08-043122950.3 KB
scim

Create SCIM invitation

Creates an invitation for a user to join the organization. The user must have an existing Hugging Face account.

post/api/organizations/{name}/scim-provisioning/v2/Users

Path parameters

namestring required

Request body

schemasstring[] required
userNamestring required

Username of the existing Hugging Face user

activeboolean
externalIdstring required

SSO unique identifier (SAML nameid or OIDC sub claim) - required for SSO login

Example request

{
  "schemas": [
    "urn:ietf:params:scim:schemas:core:2.0:User"
  ]
}

Response

SCIM User

schemasstring[] required
idstring required
externalIdstring nullable required
userNamestring required
displayNamestring required
activeboolean required

Example response

{
  "schemas": [
    "urn:ietf:params:scim:schemas:core:2.0:User"
  ],
  "id": "123",
  "externalId": "unique-identifier",
  "userName": "username",
  "displayName": "username (equals to userName)",
  "name": {
    "givenName": "John",
    "familyName": "Doe",
    "formatted": "John Doe"
  },
  "emails": [
    {
      "value": "john.doe@example.com",
      "primary": true,
      "type": "work"
    }
  ],
  "active": true,
  "meta": {
    "resourceType": "User",
    "location": "https://huggingface.co/api/organizations/:name/scim/v2/Users/:id"
  }
}