Users

Read the current authenticated identity, list and search users in the organization directory, retrieve a user by UUID, and update a user's profile. The /me/ endpoint returns context about the caller (user or agent).

See also: Organization (metadata of the organization the credential belongs to) and Invitations (invite new users, manage pending invitations).

Method	Endpoint	Description
GET	/v1/me/	Get the authenticated user
GET	/v1/users/	List and search all users
GET	/v1/users/{uuid}/	Get a specific user
PATCH	/v1/users/{uuid}/	Update a user's profile

Get Context Info

GET/v1/me/API keyCLI Auth

Retrieves contextual information about the authenticated user and their organization.

Query Parameters

Name	Type	Required	Description
`include_email`	boolean	Optional	Include the user's email in the response. Default: false.

Request

curl -X GET "https://api.dailybot.com/v1/me/" \
  -H "X-API-KEY: your_api_key"

Response200 OK

json

{
  "uuid": "user-uuid",
  "full_name": "Jane Smith",
  "image": "https://...",
  "role": "admin",
  "is_active": true,
  "bot_enabled": true,
  "timezone": "America/New_York",
  "occupation": "Designer",
  "birth_date": "02-08",
  "chat_platform_data": {},
  "work_days": [0, 1, 2, 3, 4],
  "timeoff_start": null,
  "timeoff_end": null,
  "hour_init_work": "09:00",
  "anniversary": null,
  "organization": {
    "uuid": "org-uuid",
    "name": "Acme Corp",
    "plan_name": "Pro"
  },
  "user": "Jane Smith",
  "organization_uuid": "org-uuid",
  "organization_name": "Acme Corp"
}

List Users

GET/v1/users/API keyCLI Auth

Returns a paginated list of organization members. Supports filtering and search.

Query Parameters

Name	Type	Required	Description
`search`	string	Optional	Filter by name, email, or external ID (case-insensitive).
`only_active`	boolean	Optional	If set, return only active users.
`include_email`	boolean	Optional	Include email in each user object. Default: false.
`limit`	integer	Optional	Max results per page (pagination).
`offset`	integer	Optional	Number of results to skip (pagination).

Request

curl -X GET "https://api.dailybot.com/v1/users/" \
  -H "X-API-KEY: your_api_key"

Response200 OK

json

{
  "count": 25,
  "next": "https://api.dailybot.com/v1/users/?limit=10&offset=10",
  "previous": null,
  "results": [
    {
      "uuid": "user-uuid",
      "full_name": "Jane Smith",
      "image": "https://...",
      "role": "admin",
      "is_active": true,
      "bot_enabled": true,
      "timezone": "America/New_York",
      "occupation": "Designer",
      "birth_date": "02-08",
      "chat_platform_data": {},
      "work_days": [0, 1, 2, 3, 4],
      "timeoff_start": null,
      "timeoff_end": null,
      "hour_init_work": "09:00",
      "anniversary": null,
      "organization": {
        "uuid": "...",
        "name": "Acme Corp"
      }
    }
  ]
}

Get User

GET/v1/users/{user-uuid}/API keyCLI Auth

Returns a single user by UUID.

Query Parameters

Name	Type	Required	Description
`include_email`	boolean	Optional	Include email in the response. Default: false.

Request

curl -X GET "https://api.dailybot.com/v1/users/a1b2c3d4-e5f6-7890-abcd-ef1234567890/" \
  -H "X-API-KEY: your_api_key"

Response200 OK

json

{
  "uuid": "user-uuid",
  "full_name": "Jane Smith",
  "image": "https://...",
  "role": "admin",
  "is_active": true,
  "bot_enabled": true,
  "timezone": "America/New_York",
  "occupation": "Designer",
  "birth_date": "02-08",
  "chat_platform_data": {},
  "work_days": [0, 1, 2, 3, 4],
  "timeoff_start": null,
  "timeoff_end": null,
  "hour_init_work": "09:00",
  "anniversary": null,
  "organization": {
    "uuid": "org-uuid",
    "name": "Acme Corp"
  }
}

Response404 Not Found

json

{
  "detail": "Not found.",
  "code": "not_found"
}

Update User

PATCH/v1/users/{user-uuid}/API keyCLI Auth

Updates a user's profile. Only provided fields are modified.

Body Parameters

Name	Type	Required	Description
`full_name`	string	Optional	Full name.
`occupation`	string	Optional	Job title or occupation.
`birth_date`	string	Optional	Birth date in MM-DD format.
`timezone`	string	Optional	IANA timezone (e.g. America/New_York).
`work_days`	array of integers	Optional	Working days (0=Monday, 6=Sunday).
`timeoff_start`	string	Optional	Time-off start date.
`timeoff_end`	string	Optional	Time-off end date.
`hour_init_work`	string	Optional	Work start time (e.g. HH:MM).
`active`	boolean	Optional	Whether the user is active.
`bot_enabled`	boolean	Optional	Whether Dailybot is enabled for this user.

Request

curl -X PATCH "https://api.dailybot.com/v1/users/a1b2c3d4-e5f6-7890-abcd-ef1234567890/" \
  -H "X-API-KEY: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "full_name": "Jane Smith"
  }'

Response200 OK

json

{
  "uuid": "user-uuid",
  "full_name": "Jane Smith",
  "image": "https://...",
  "role": "admin",
  "is_active": true,
  "bot_enabled": true,
  "timezone": "America/New_York",
  "occupation": "Designer",
  "birth_date": "02-08",
  "chat_platform_data": {},
  "work_days": [0, 1, 2, 3, 4],
  "timeoff_start": null,
  "timeoff_end": null,
  "hour_init_work": "09:00",
  "anniversary": null,
  "organization": {
    "uuid": "org-uuid",
    "name": "Acme Corp"
  }
}

Response400 Bad Request

json

{
  "detail": "Birth date has an invalid date format. It must be in MM-DD format.",
  "code": "bad_birth_date_format"
}