Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.toktra.dev/llms.txt

Use this file to discover all available pages before exploring further.

​
List users

Returns a cursor-paginated list of users in your organization. 
GET /v1/users
​
cursor
string
Opaque pagination cursor. Pass next_cursor from a previous response. Omit for the first page.
​
limit
integer
default:"25"
Maximum items per page (1–100).
​
status
string
Filter by account status: active, inactive, or suspended.
​
department
string
Filter by department name (e.g., engineering).

​
Request

curl "https://api.toktra.io/v1/users?status=active&department=engineering" \
  -H "Authorization: Bearer YOUR_TOKEN"

​
Response

{
  "items": [
    {
      "id": "u1a2b3c4-0000-0000-0000-000000000001",
      "org_id": "a1b2c3d4-0000-0000-0000-000000000000",
      "email": "jane.smith@acme.com",
      "name": "Jane Smith",
      "department": "Engineering",
      "role": "member",
      "status": "active",
      "last_active_at": "2025-01-15T09:45:00Z",
      "created_at": "2024-06-01T00:00:00Z",
      "updated_at": "2025-01-15T09:45:00Z"
    }
  ],
  "next_cursor": "eyJpZCI6InUxYTJiM2M0In0",
  "has_more": true,
  "total_count": 214
}

​
User object

​
id
string
Unique user identifier (UUID).
​
org_id
string
Organization this user belongs to.
​
email
string
User’s email address.
​
name
string
User’s full name.
​
department
string
Department name. null if not assigned.
​
role
string
Role within the organization (e.g., member, admin).
​
status
string
Account status: active, inactive, or suspended. Suspended users have had their LLM access revoked via lockout.
​
last_active_at
string
ISO 8601 timestamp of the user’s most recent LLM activity. null if no activity recorded yet.
​
created_at
string
ISO 8601 creation timestamp.
​
updated_at
string
ISO 8601 last-updated timestamp.
Combine this endpoint with GET /v1/usage — filter usage by user_id to get a per-user breakdown of token consumption.