Sign in

v37

latestOpenAPI 3.1.0raw.githubusercontent.com2026-06-1170194628.0 KB
v1
User

Create User

Create a new user or link existing user to developer

post/v1/user

Headers

X-API-Keystring required

Request body

emailstring email nullable
external_idstring required
metadataobject nullable
type'developerUser' | 'user' | 'agent'

Example request

{
  "email": "user@example.com",
  "external_id": "user123",
  "metadata": {
    "name": "John Doe",
    "preferences": {
      "theme": "dark"
    }
  },
  "type": "developerUser"
}

Response

Successful Response

codeinteger required

HTTP status code

statusstring required

'success' or 'error'

user_idstring nullable
emailstring nullable
external_idstring nullable
metadataobject nullable
created_atstring nullable
updated_atstring nullable
errorstring nullable
{"stackTrail":"components:schemas:UserResponse:properties:details:anyOf","oasType":"schema","type":"unknown","title":"Details","nullable":true}

Example response

{
  "code": 200,
  "created_at": "2024-03-20T10:00:00.000Z",
  "email": "user@example.com",
  "external_id": "user123",
  "metadata": {
    "name": "John Doe",
    "preferences": {
      "theme": "dark"
    }
  },
  "status": "success",
  "updated_at": "2024-03-20T10:00:00.000Z",
  "user_id": "abc123"
}