Sign in

v29

latestOpenAPI 3.1.0raw.githubusercontent.com2026-03-233765161.7 KB
v1 users

Create a new user or return existing user

Create a new user in the UPL system or return existing user.

This endpoint:
- Validates authentication tokens
- Creates a new user with unique email OR returns existing user if email already exists
- Returns user details upon successful creation or retrieval
- Uses "create or get" pattern for idempotent behavior

**Authentication**: Requires valid API key or JWT token in Authorization header
post/v1/users

Request body

emailstring required

User's email address

namestring required

User's full name

org_user_idstring nullable

Organization-specific user ID

persona_idstring nullable

If provided, the new user is automatically linked to this persona (cloning its knowledge graph).

Example request

{
  "email": "user@example.com",
  "name": "John Doe",
  "org_user_id": "org_123456"
}

Response

Successful Response

user_idstring required

Generated user ID

emailstring required

User's email address

namestring required

User's name

org_user_idstring nullable

Organization-specific user ID

created_atstring required

User creation timestamp

successboolean

Whether the user was created successfully

Example response

{
  "created_at": "2024-01-01T00:00:00Z",
  "email": "user@example.com",
  "name": "John Doe",
  "org_user_id": "org_123456",
  "success": true,
  "user_id": "123e4567-e89b-12d3-a456-426614174000"
}