Skip to content
ver .md sin procesar

Usuarios

Consulta el directorio de la organización, obtén perfiles de usuario y actualiza metadata. Admite tanto API keys como tokens Bearer del CLI.

GET/v1/me/API keyCLI AuthOAuth 2.0

Current authenticated identity

Returns the current authenticated user (or agent identity for API-Key requests). Supports include_email query.

Parámetros de consulta

NombreTipoRequeridoDescripción
include_emailbooleanOpcionalInclude email in response. Default false.

Errores

EstadoCuándo
401Missing/invalid/expired credential
403Authenticated but not permitted
429Throttled - Retry-After header set
curl -sS -X GET 'https://api.dailybot.com/v1/me/' -H 'X-API-KEY: $DAILYBOT_API_KEY'

Probarlo

Este es un asistente de solo copia — la solicitud no se envía desde tu navegador. Pega el comando en tu terminal para ejecutarlo.

GET/v1/users/API keyCLI AuthPaginación por número de página

List organization members

Paginated list of users. Supports search, only_active, include_email.

Parámetros de consulta

NombreTipoRequeridoDescripción
searchstringOpcionalFilter by name, email, or external ID (case-insensitive).
only_activebooleanOpcionalIf set, return only active users.
include_emailbooleanOpcionalInclude email in each user object.
pageintegerOpcionalPage number (page-number pagination).
page_sizeintegerOpcionalPage size (default 20, max 100).

Errores

EstadoCuándo
401Missing/invalid/expired credential
403Authenticated but not permitted
429Throttled - Retry-After header set
curl -sS -X GET 'https://api.dailybot.com/v1/users/' -H 'X-API-KEY: $DAILYBOT_API_KEY'

Probarlo

Este es un asistente de solo copia — la solicitud no se envía desde tu navegador. Pega el comando en tu terminal para ejecutarlo.

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

Retrieve a user by UUID

Retrieves a single user by their UUID.

Parámetros de ruta

NombreTipoRequeridoDescripción
uuidstring (uuid)Requerido

Parámetros de consulta

NombreTipoRequeridoDescripción
include_emailbooleanOpcional

Errores

EstadoCuándo
401Missing/invalid/expired credential
403Authenticated but not permitted
429Throttled - Retry-After header set
404Not found or not visible
curl -sS -X GET 'https://api.dailybot.com/v1/users/{uuid}/' -H 'X-API-KEY: $DAILYBOT_API_KEY'

Probarlo

Este es un asistente de solo copia — la solicitud no se envía desde tu navegador. Pega el comando en tu terminal para ejecutarlo.

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

Update a user

Partially update a user profile.

Parámetros de ruta

NombreTipoRequeridoDescripción
uuidstring (uuid)Requerido

Errores

EstadoCuándo
401Missing/invalid/expired credential
403Authenticated but not permitted
429Throttled - Retry-After header set
400Validation error
404Not found or not visible
curl -sS -X PATCH 'https://api.dailybot.com/v1/users/{uuid}/' -H 'X-API-KEY: $DAILYBOT_API_KEY'

Probarlo

Este es un asistente de solo copia — la solicitud no se envía desde tu navegador. Pega el comando en tu terminal para ejecutarlo.

PATCH/v1/users/{uuid}/update-metadata/API keyCLI Auth

Update user metadata

Merge arbitrary key/value metadata onto a user.

Parámetros de ruta

NombreTipoRequeridoDescripción
uuidstring (uuid)Requerido

Errores

EstadoCuándo
401Missing/invalid/expired credential
403Authenticated but not permitted
429Throttled - Retry-After header set
400Validation error
404Not found or not visible
curl -sS -X PATCH 'https://api.dailybot.com/v1/users/{uuid}/update-metadata/' -H 'X-API-KEY: $DAILYBOT_API_KEY'

Probarlo

Este es un asistente de solo copia — la solicitud no se envía desde tu navegador. Pega el comando en tu terminal para ejecutarlo.

Usuarios y Organización

Gestiona usuarios, obtén información de contexto (/me), recupera detalles de la organización, actualiza perfiles y metadatos, e invita miembros.

Resumen de endpoints

Método Endpoint Descripción
GET /v1/me/ Información del usuario autenticado + organización
GET /v1/organization/ Detalles de la organización
GET /v1/users/ Listar todos los usuarios
GET /v1/users/{uuid}/ Obtener un usuario específico
PATCH /v1/users/{uuid}/ Actualizar un usuario
POST /v1/invite-user/ Invitar un usuario (ver API de Invitaciones)

GET /v1/users/

Devuelve todos los usuarios de la organización. Paginado (ordenación por defecto: full_name).

Parámetros de query

Nombre Tipo Default Descripción
page integer 1 Número de página. offset aceptado como alias.
page_size integer 50 Ítems por página (máx. 200). limit aceptado como alias.
search string Búsqueda sin distinción de mayúsculas en nombre completo o email (máx. 256 chars).
is_active boolean Filtrar por estado activo.
role string Filtrar por rol: admin o member.
curl "https://api.dailybot.com/v1/users/?is_active=true&search=alice&page_size=50" \
  -H "X-API-KEY: $DAILYBOT_API_KEY"

Respuesta (200 OK):

{
  "count": 1,
  "next": null,
  "previous": null,
  "results": [
    {
      "uuid": "usr_abc123",
      "email": "alice@empresa.com",
      "first_name": "Alice",
      "last_name": "García",
      "role": "member",
      "is_active": true,
      "timezone": "America/Bogota"
    }
  ]
}

PATCH /v1/users/{uuid}/

Actualiza el perfil o metadatos de un usuario. Solo los Administradores de Organización pueden actualizar otros usuarios.

Parámetros del body

Nombre Tipo Requerido Descripción
first_name string No Nombre del usuario.
last_name string No Apellido del usuario.
timezone string No Zona horaria IANA (p.ej. America/Bogota).
metadata object No Metadatos clave-valor personalizados del usuario.