Usuarios

Lee la identidad autenticada actual, lista y busca usuarios en el directorio de la organización, obtén un usuario por UUID y actualiza el perfil de un usuario. El endpoint /me/devuelve el contexto del propietario de la credencial (usuario o agente).

Ver también: Organización (metadatos de la organización a la que pertenece la credencial) e Invitaciones (invitar nuevos usuarios, gestionar invitaciones pendientes).

Método	Endpoint	Descripción
GET	/v1/me/	Obtener el usuario autenticado
GET	/v1/users/	Listar y buscar todos los usuarios
GET	/v1/users/{uuid}/	Obtener un usuario específico
PATCH	/v1/users/{uuid}/	Actualizar el perfil de un usuario

Obtener Información de Contexto

GET/v1/me/API keyCLI Auth

Obtiene información contextual del usuario autenticado y su organización.

Parámetros de Consulta

Name	Type	Required	Description
`include_email`	boolean	Optional	Incluir el email del usuario en la respuesta. Por defecto: false.

Petición

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

Response200 OK

json

{
  "uuid": "user-uuid",
  "full_name": "María García",
  "image": "https://...",
  "role": "admin",
  "is_active": true,
  "bot_enabled": true,
  "timezone": "America/Bogota",
  "occupation": "Diseñadora",
  "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": "María García",
  "organization_uuid": "org-uuid",
  "organization_name": "Acme Corp"
}

Listar Usuarios

GET/v1/users/API keyCLI Auth

Devuelve una lista paginada de miembros de la organización. Admite filtros y búsqueda.

Parámetros de Consulta

Name	Type	Required	Description
`search`	string	Optional	Filtrar por nombre, email o ID externo (sin distinguir mayúsculas).
`only_active`	boolean	Optional	Si está definido, devolver solo usuarios activos.
`include_email`	boolean	Optional	Incluir email en cada objeto de usuario. Por defecto: false.
`limit`	integer	Optional	Máximo de resultados por página (paginación).
`offset`	integer	Optional	Número de resultados a omitir (paginación).

Petición

curl -X GET "https://api.dailybot.com/v1/users/" \
  -H "X-API-KEY: tu_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": "María García",
      "image": "https://...",
      "role": "admin",
      "is_active": true,
      "bot_enabled": true,
      "timezone": "America/Bogota",
      "occupation": "Diseñadora",
      "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"
      }
    }
  ]
}

Obtener Usuario

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

Devuelve un usuario por UUID.

Parámetros de Consulta

Name	Type	Required	Description
`include_email`	boolean	Optional	Incluir email en la respuesta. Por defecto: false.

Petición

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

Response200 OK

json

{
  "uuid": "user-uuid",
  "full_name": "María García",
  "image": "https://...",
  "role": "admin",
  "is_active": true,
  "bot_enabled": true,
  "timezone": "America/Bogota",
  "occupation": "Diseñadora",
  "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"
}

Actualizar Usuario

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

Actualiza el perfil de un usuario. Solo se modifican los campos proporcionados.

Parámetros del Cuerpo

Name	Type	Required	Description
`full_name`	string	Optional	Nombre completo.
`occupation`	string	Optional	Cargo u ocupación.
`birth_date`	string	Optional	Fecha de nacimiento en formato MM-DD.
`timezone`	string	Optional	Zona horaria IANA (ej. America/New_York).
`work_days`	array of integers	Optional	Días laborales (0=Lunes, 6=Domingo).
`timeoff_start`	string	Optional	Fecha de inicio de descanso.
`timeoff_end`	string	Optional	Fecha de fin de descanso.
`hour_init_work`	string	Optional	Hora de inicio laboral (ej. HH:MM).
`active`	boolean	Optional	Si el usuario está activo.
`bot_enabled`	boolean	Optional	Si Dailybot está habilitado para este usuario.

Petición

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

Response200 OK

json

{
  "uuid": "user-uuid",
  "full_name": "María García",
  "image": "https://...",
  "role": "admin",
  "is_active": true,
  "bot_enabled": true,
  "timezone": "America/Bogota",
  "occupation": "Diseñadora",
  "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"
}