Create users in workspace
Bulk-creates placeholder agent users in a partner-managed workspace. Each request specifies a count of users to create. For every user the platform: assigns the agent role and activated status, creates a non-login, system-managed email <user_id>-<workspace-id>@partners.timelines.ai, assigns the user to the workspace's Default group, consumes one seat from the workspace. The operation is all-or-nothing: if there are not enough available seats to satisfy count, the request fails with a seats_full error and no users are created. On success the response returns updated seat counters and the list of created users, including their identifiers and metadata needed for downstream QR-link generation.
Path parameters
The unique identifier for the workspace.
Headers
The unique identifier for the partner.
Request body
Example request
{
"count": 3
}Response
Users created
Example response
{
"workspace_id": "my-first-workspace",
"seats_total": 3,
"seats_available": 2,
"users": [
{
"user_id": 42,
"display_name": "John Doe",
"role": "owner",
"email": "admin@timelines.ai",
"status": "active",
"created_at": "2024-01-01T10:00:00Z"
}
]
}