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

Nombre	Tipo	Requerido	Descripción
include_email	boolean	Opcional	Include email in response. Default false.

Errores

Estado	Cuándo
401	Missing/invalid/expired credential
403	Authenticated but not permitted
429	Throttled - 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

Nombre	Tipo	Requerido	Descripción
search	string	Opcional	Filter by name, email, or external ID (case-insensitive).
only_active	boolean	Opcional	If set, return only active users.
include_email	boolean	Opcional	Include email in each user object.
page	integer	Opcional	Page number (page-number pagination).
page_size	integer	Opcional	Page size (default 20, max 100).

Errores

Estado	Cuándo
401	Missing/invalid/expired credential
403	Authenticated but not permitted
429	Throttled - 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

Nombre	Tipo	Requerido	Descripción
uuid	string (uuid)	Requerido	—

Parámetros de consulta

Nombre	Tipo	Requerido	Descripción
include_email	boolean	Opcional	—

Errores

Estado	Cuándo
401	Missing/invalid/expired credential
403	Authenticated but not permitted
429	Throttled - Retry-After header set
404	Not 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

Nombre	Tipo	Requerido	Descripción
uuid	string (uuid)	Requerido	—

Errores

Estado	Cuándo
401	Missing/invalid/expired credential
403	Authenticated but not permitted
429	Throttled - Retry-After header set
400	Validation error
404	Not 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

Nombre	Tipo	Requerido	Descripción
uuid	string (uuid)	Requerido	—

Errores

Estado	Cuándo
401	Missing/invalid/expired credential
403	Authenticated but not permitted
429	Throttled - Retry-After header set
400	Validation error
404	Not 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.

GET/v1/me/dashboard-preferences/{surface}/API keyCLI AuthOAuth 2.0

Obtener preferencias del dashboard

Devuelve los últimos filtros aplicados para una superficie (forms_home, workflows_home, followups_home). Sin preferencia → 200 con filters vacíos.

Parámetros de ruta

Nombre	Tipo	Requerido	Descripción
surface	string	Requerido	—

Respuesta

{
  "surface": "string (forms_home | workflows_home | followups_home)",
  "schema_version": "integer",
  "filters": "object",
  "updated_at": "string | null (ISO-8601)"
}

Errores

Estado	Cuándo
401	Credencial ausente, inválida o expirada
403	Autenticado pero sin permiso
429	Limitado — encabezado Retry-After presente
404	not_found — superficie no soportada

curl -sS -X GET 'https://api.dailybot.com/v1/me/dashboard-preferences/forms_home/' \
  -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.

No requiere elegibilidad de Etiquetas. Cuando Labels no están disponibles, los filtros de etiqueta pueden omitirse con advertencia labels_feature_unavailable.

PUT/v1/me/dashboard-preferences/{surface}/API keyCLI AuthOAuth 2.0

Guardar preferencias del dashboard

Crea o actualiza los últimos filtros aplicados para una superficie.

Parámetros de ruta

Nombre	Tipo	Requerido	Descripción
surface	string	Requerido	—

Cuerpo de la solicitud

{
  "schema_version": 1,
  "filters": "object (canonical)",
  "payload": "object (optional legacy alias; filters wins when both are sent)"
}

Errores

Estado	Cuándo
401	Credencial ausente, inválida o expirada
403	Autenticado pero sin permiso
400	invalid_preference_payload — cuerpo inválido (schema_version / filters)
429	Limitado — encabezado Retry-After presente
404	not_found — superficie no soportada

curl -sS -X PUT 'https://api.dailybot.com/v1/me/dashboard-preferences/forms_home/' \
  -H 'X-API-KEY: $DAILYBOT_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"schema_version": 1, "filters": {}}'

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.

No requiere elegibilidad de Etiquetas. Superficie no soportada → 404 not_found; cuerpo malformado → 400 invalid_preference_payload.

DELETE/v1/me/dashboard-preferences/{surface}/API keyCLI AuthOAuth 2.0

Eliminar preferencias del dashboard

Borra los últimos filtros aplicados para una superficie. 204 idempotente.

Parámetros de ruta

Nombre	Tipo	Requerido	Descripción
surface	string	Requerido	—

Errores

Estado	Cuándo
401	Credencial ausente, inválida o expirada
403	Autenticado pero sin permiso
429	Limitado — encabezado Retry-After presente
404	not_found — superficie no soportada

curl -sS -X DELETE 'https://api.dailybot.com/v1/me/dashboard-preferences/forms_home/' \
  -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.

No requiere elegibilidad de Etiquetas. Idempotente: sin preferencia sigue devolviendo 204.

GET/v1/me/saved-views/API keyCLI AuthOAuth 2.0

Listar vistas guardadas

Lista las vistas guardadas del llamante. Filtro opcional por superficie.

Parámetros de consulta

Nombre	Tipo	Requerido	Descripción
surface	string	Opcional	Filtra por superficie.

Respuesta

{
  "results": "array<{ uuid, surface, name, schema_version, filters, created_at, updated_at }>"
}

Errores

Estado	Cuándo
401	Credencial ausente, inválida o expirada
403	Autenticado pero sin permiso
400	invalid_preference_payload — query inválida (p.ej. superficie no soportada)
429	Limitado — encabezado Retry-After presente

curl -sS -X GET 'https://api.dailybot.com/v1/me/saved-views/' \
  -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.

No requiere elegibilidad de Etiquetas. Cuando Labels no están disponibles, los filtros de etiqueta pueden omitirse con advertencia labels_feature_unavailable.

POST/v1/me/saved-views/API keyCLI AuthOAuth 2.0

Crear vista guardada

Crea una vista guardada con nombre para una superficie.

Cuerpo de la solicitud

{
  "surface": "string",
  "name": "string",
  "schema_version": 1,
  "filters": "object (canonical)",
  "payload": "object (optional legacy alias; filters wins when both are sent)"
}

Errores

Estado	Cuándo
401	Credencial ausente, inválida o expirada
403	Autenticado pero sin permiso
400	invalid_preference_payload — cuerpo inválido (p.ej. superficie no soportada)
429	Limitado — encabezado Retry-After presente
409	duplicate_name — ya existe una vista con ese nombre en esta superficie

curl -sS -X POST 'https://api.dailybot.com/v1/me/saved-views/' \
  -H 'X-API-KEY: $DAILYBOT_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"surface": "forms_home", "name": "My view", "schema_version": 1, "filters": {}}'

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.

No requiere elegibilidad de Etiquetas. Cuando Labels no están disponibles, los filtros de etiqueta pueden omitirse con advertencia labels_feature_unavailable.

GET/v1/me/saved-views/{view_uuid}/API keyCLI AuthOAuth 2.0

Obtener vista guardada

Obtiene una vista guardada por UUID.

Parámetros de ruta

Nombre	Tipo	Requerido	Descripción
view_uuid	string (uuid)	Requerido	—

Respuesta

{
  "uuid": "string (uuid)",
  "surface": "string",
  "name": "string",
  "schema_version": "integer",
  "filters": "object",
  "created_at": "string (ISO-8601)",
  "updated_at": "string (ISO-8601)"
}

Errores

Estado	Cuándo
401	Credencial ausente, inválida o expirada
403	Autenticado pero sin permiso
429	Limitado — encabezado Retry-After presente
404	Superficie no soportada o vista no encontrada

curl -sS -X GET 'https://api.dailybot.com/v1/me/saved-views/{view_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.

No requiere elegibilidad de Etiquetas. Cuando Labels no están disponibles, los filtros de etiqueta pueden omitirse con advertencia labels_feature_unavailable.

PATCH/v1/me/saved-views/{view_uuid}/API keyCLI AuthOAuth 2.0

Actualizar vista guardada

Actualiza el nombre o los filtros de una vista guardada.

Parámetros de ruta

Nombre	Tipo	Requerido	Descripción
view_uuid	string (uuid)	Requerido	—

Cuerpo de la solicitud

{
  "name": "string (optional)",
  "filters": "object (optional, canonical)",
  "payload": "object (optional legacy alias; filters wins when both are sent)"
}

Errores

Estado	Cuándo
401	Credencial ausente, inválida o expirada
403	Autenticado pero sin permiso
429	Limitado — encabezado Retry-After presente
404	Superficie no soportada o vista no encontrada

curl -sS -X PATCH 'https://api.dailybot.com/v1/me/saved-views/{view_uuid}/' \
  -H 'X-API-KEY: $DAILYBOT_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"name": "Renamed view", "filters": {}}'

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.

No requiere elegibilidad de Etiquetas. Cuando Labels no están disponibles, los filtros de etiqueta pueden omitirse con advertencia labels_feature_unavailable.

DELETE/v1/me/saved-views/{view_uuid}/API keyCLI AuthOAuth 2.0

Eliminar vista guardada

Elimina una vista guardada.

Parámetros de ruta

Nombre	Tipo	Requerido	Descripción
view_uuid	string (uuid)	Requerido	—

Errores

Estado	Cuándo
401	Credencial ausente, inválida o expirada
403	Autenticado pero sin permiso
429	Limitado — encabezado Retry-After presente
404	Superficie no soportada o vista no encontrada

curl -sS -X DELETE 'https://api.dailybot.com/v1/me/saved-views/{view_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.

No requiere elegibilidad de Etiquetas. Cuando Labels no están disponibles, los filtros de etiqueta pueden omitirse con advertencia labels_feature_unavailable.

GET/v1/me/featured/API keyCLI AuthOAuth 2.0

Listar entidades Featured

Lista los UUID Featured del llamante para un entity_type requerido (forms, automations o checkins).

Parámetros de consulta

Nombre	Tipo	Requerido	Descripción
entity_type	string	Requerido	Requerido. Uno de forms, automations o checkins.

Respuesta

{
  "entity_type": "string (forms | automations | checkins)",
  "entity_uuids": "array<string (uuid)>"
}

Errores

Estado	Cuándo
401	Credencial ausente, inválida o expirada
403	Autenticado pero sin permiso
400	invalid_preference_payload — entity_type ausente o inválido (código compartido de personalización)
429	Limitado — encabezado Retry-After presente

curl -sS -X GET 'https://api.dailybot.com/v1/me/featured/?entity_type=forms' \
  -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.

Featured es privado por usuario — is_featured en listados refleja solo al llamante.

PUT/v1/me/featured/{entity_type}/{entity_uuid}/API keyCLI AuthOAuth 2.0

Marcar o desmarcar Featured

Activa o desactiva Featured para una entidad (privado del llamante).

Parámetros de ruta

Nombre	Tipo	Requerido	Descripción
entity_type	string	Requerido	—
entity_uuid	string (uuid)	Requerido	—

Cuerpo de la solicitud

{
  "featured": "boolean"
}

Errores

Estado	Cuándo
401	Credencial ausente, inválida o expirada
403	Autenticado pero sin permiso
400	invalid_featured_request — entity_type no soportado o cuerpo inválido
429	Limitado — encabezado Retry-After presente
404	not_found — entity_uuid desconocido (entidad no visible o ausente)

curl -sS -X PUT 'https://api.dailybot.com/v1/me/featured/forms/{entity_uuid}/' \
  -H 'X-API-KEY: $DAILYBOT_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"featured": true}'

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.

Featured es privado por usuario — is_featured en listados refleja solo al llamante.

POST/v1/me/featured/batch/API keyCLI AuthOAuth 2.0

Featured en lote

Marca o desmarca Featured en varias entidades para el llamante.

Cuerpo de la solicitud

{
  "entity_type": "string",
  "items": "array<{entity_uuid, featured}>"
}

Errores

Estado	Cuándo
401	Credencial ausente, inválida o expirada
403	Autenticado pero sin permiso
400	invalid_featured_request — entity_type no soportado o cuerpo inválido
429	Limitado — encabezado Retry-After presente
404	not_found — entity_uuid desconocido (entidad no visible o ausente)

curl -sS -X POST 'https://api.dailybot.com/v1/me/featured/batch/' \
  -H 'X-API-KEY: $DAILYBOT_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"entity_type": "forms", "items": [{"entity_uuid": "{uuid}", "featured": true}]}'

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.

Featured es privado por usuario — is_featured en listados refleja solo al llamante.

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)

Personalización

Estado privado por usuario bajo /v1/me/.... No requiere elegibilidad de Etiquetas: cualquier miembro autenticado puede usar preferencias, vistas guardadas y Featured.

Métodos	Ruta	Uso
GET/PUT/DELETE	`/v1/me/dashboard-preferences/{surface}/`	Últimos filtros para `forms_home`, `workflows_home` o `followups_home`
GET/POST	`/v1/me/saved-views/`	Listar o crear vistas guardadas
GET/PATCH/DELETE	`/v1/me/saved-views/{view_uuid}/`	Gestionar una vista
GET	`/v1/me/featured/?entity_type=`	Listar UUID Featured (`forms`, `automations`, `checkins`)
PUT	`/v1/me/featured/{entity_type}/{entity_uuid}/`	Alternar Featured (`{"featured": true\|false}`)
POST	`/v1/me/featured/batch/`	Featured en lote

Preferencia vacía: GET /v1/me/dashboard-preferences/{surface}/ sin estado guardado responde 200:

{"surface": "forms_home", "schema_version": 1, "filters": {}, "updated_at": null}

DELETE de preferencias es idempotente (204). Las escrituras aceptan filters canónico; el legado payload sigue aceptado (filters gana si se envían ambos).

Cuando Etiquetas no están disponibles, las preferencias pueden conservar filtros de etiqueta en reposo, pero las respuestas los omiten con la advertencia labels_feature_unavailable.

Featured es privado por usuario — is_featured en listados refleja solo al llamante.

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": "[email protected]",
      "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.