Create scim connection

POST/workspaces/{organizationId}/scim/connections

Path parameters

organizationIdstringrequired

Request body

application/json

scopesstring[]

min items 1

expiresInDaysinteger

max 365

Responses

201

SCIM connection created — the bearer token is returned once and is not recoverable later.

connectionIdstringrequired

provisioningDomainIdstringrequired

tokenstringrequired

baseUrlstringrequired

403

Requires owner or admin role in the workspace

Try it

Server

Custom base URLOverrides the selected server when set.

Parameters

organizationIdpath*

Bodyapplication/json

Request body

Request

curl -X POST '/workspaces/string/scim/connections' \
  -H 'Content-Type: application/json' \
  -d '{
  "scopes": [
    "scim.users.read"
  ],
  "expiresInDays": 1
}'

const response = await fetch("/workspaces/string/scim/connections", {
  method: "POST",
  headers: {
    "Content-Type": "application/json"
  },
  body: "{\n  \"scopes\": [\n    \"scim.users.read\"\n  ],\n  \"expiresInDays\": 1\n}"
});

import requests

response = requests.post(
    "/workspaces/string/scim/connections",
    headers={
        "Content-Type": "application/json"
    },
    data="{\n  \"scopes\": [\n    \"scim.users.read\"\n  ],\n  \"expiresInDays\": 1\n}",
)

Response

{
  "connectionId": "string",
  "provisioningDomainId": "string",
  "token": "string",
  "baseUrl": "string"
}