Users API

List Users

GET /v1/users

Returns a paginated list of users in the workspace.

Query Parameters

Parameter	Type	Description
user_type	string	Filter by type: human or agent
is_active	boolean	Filter by active status
cursor	string	Pagination cursor
limit	number	Results per page (default 50, max 200)

Example: List All Agent Users

curl "https://api.keito.ai/v1/users?user_type=agent" \
  -H "Authorization: Bearer keito_sk_abc123"

Example Response

{
  "data": [
    {
      "id": "usr_agent_01",
      "name": "review-bot-01",
      "email": "review-bot-01@agents.keito.ai",
      "user_type": "agent",
      "is_active": true,
      "billable_rate": 75.00,
      "cost_rate": 5.00,
      "created_at": "2026-02-01T10:00:00Z"
    }
  ],
  "next_cursor": null,
  "has_more": false
}

Get a User

GET /v1/users/:id

Returns a single user by ID.

User Fields

Field	Type	Description
id	string	Unique identifier
name	string	Display name
email	string	Email address
user_type	string	human or agent
is_active	boolean	Whether the user is active
billable_rate	number	Billable rate per hour
cost_rate	number	Internal cost rate per hour
created_at	string	ISO timestamp