Provision a user

Adds a member to the organization, creating the LangWatch account when the email is new. Someone who already has an account is added and reactivated rather than refused, which is what lets a directory sync be re-run without special-casing the people it already knows. New members join with the MEMBER role at organization scope. costCenter on the enterprise user extension assigns their department, creating that department on first use.

POST /api/scim/v2/Users

Provision a user

Python

import requests

url = "https://app.langwatch.ai/api/scim/v2/Users"

payload = {
    "schemas": ["<string>"],
    "userName": "[e-mail]"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/scim+json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

201

{
  "schemas": [
    "urn:ietf:params:scim:schemas:core:2.0:User"
  ],
  "id": "<string>",
  "userName": "<string>",
  "name": {
    "givenName": "<string>",
    "familyName": "<string>"
  },
  "emails": [
    {
      "primary": true,
      "value": "<string>",
      "type": "<string>"
    }
  ],
  "active": true,
  "meta": {
    "resourceType": "User",
    "created": "<string>",
    "lastModified": "<string>"
  },
  "externalId": "<string>"
}

Authorizations

Authorization · string · header · required

SCIM token for one organization's directory connection, created with POST /api/scim-tokens or in Settings > SCIM. It authenticates provisioning calls only, and stops working if the organization's Enterprise plan lapses.

Body

application/scim+json

schemas · string[] · required

userName · string<email> · required

Pattern: ^(?:[A-Za-z0-9_'+\-]+\.)*[A-Za-z0-9_'+\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$

externalId · string

Minimum string length: 1

name · object

Show child attributes

emails · object[]

Show child attributes

active · boolean

urn:ietf:params:scim:schemas:extension:enterprise:2.0:User · object

Show child attributes

{key} · any

Response

201

application/scim+json

The provisioned user.

schemas · string[] · required

Allowed value: "urn:ietf:params:scim:schemas:core:2.0:User"

id · string · required

userName · string · required

name · object · required

Show child attributes

emails · object[] · required

Show child attributes

active · boolean · required

meta · object · required

Show child attributes

externalId · string