Dailybot | Etiquetas

Taxonomía organizacional para Formularios, Automatizaciones y Check-ins. Requiere elegibilidad de Etiquetas (función habilitada). CRUD en Configuración, asignación a entidades, filtrado en listados. Invitados denegados.

GET/v1/labels/entitlement/API keyCLI Auth

Elegibilidad de etiquetas

Indica si el llamante tiene acceso a Etiquetas (función habilitada para la organización y el llamante no es invitado). Siempre devuelve flags de elegibilidad — nunca bloquea la respuesta. Sin función e invitados reciben entitled=false con códigos de razón.

Respuesta

{
  "entitled": "boolean",
  "feature": "string",
  "reason": "string | null (feature_not_enabled | guest_not_allowed | organization_required)",
  "is_guest": "boolean",
  "can_create": "boolean",
  "can_manage_all": "boolean",
  "can_hard_delete": "boolean",
  "can_manage": "boolean (same as can_create when entitled)"
}

Errores

Estado	Cuándo
401	Credencial ausente, inválida o expirada
429	Limitado — encabezado Retry-After presente

curl -sS 'https://api.dailybot.com/v1/labels/entitlement/' \
  -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.

Llama esto antes de construir UI de Etiquetas o flujos de asignación. Los invitados siempre reciben is_guest=true y entitled=false.

GET/v1/labels/API keyCLI AuthPaginación limit-offset

Listar etiquetas de la organización

Listado paginado de Etiquetas organizacionales para Configuración y selectores. Requiere elegibilidad de Etiquetas (función habilitada). Cada fila incluye usage canónico: {forms, automations, checkins, total}.

Parámetros de consulta

Nombre	Tipo	Requerido	Descripción
search	string	Opcional	Subcadena sin distinción de mayúsculas en el nombre de la etiqueta.
owner_user_ids	string (CSV)	Opcional	Filtra por UUIDs de creadores (máx. 50).
is_archived	boolean	Opcional	Si es true, lista etiquetas archivadas. Por defecto false.
order	string	Opcional	Campo de orden: name, usage, last_applied_at, created_at. Por defecto name.
is_ascend	boolean	Opcional	Dirección de ordenamiento. Por defecto ascendente para name.
limit	integer	Opcional	Tamaño de página. Por defecto 20, mín. 1, máx. 100.
offset	integer	Opcional	Offset de paginación. Por defecto 0.

Respuesta

{
  "count": "integer",
  "next": "string | null",
  "previous": "string | null",
  "results": "array<Label>"
}

Errores

Estado	Cuándo
401	Credencial ausente, inválida o expirada
403	feature_not_available, permission_denied, guest_not_allowed
429	Limitado — encabezado Retry-After presente

curl -sS 'https://api.dailybot.com/v1/labels/?order=usage&is_ascend=false&limit=50' \
  -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.

POST/v1/labels/API keyCLI Auth

Crear una etiqueta

Crea una Etiqueta organizacional. Requiere elegibilidad de Etiquetas (función habilitada) y permiso can_create. Los nombres son únicos sin distinción de mayúsculas por organización.

Cuerpo de la solicitud

{
  "name": "string (required)",
  "color": "string (hex, optional, default system color)",
  "description": "string | null (optional)"
}

Respuesta

{
  "uuid": "string",
  "name": "string",
  "color": "string",
  "description": "string | null",
  "is_archived": "boolean",
  "usage": "{forms, automations, checkins, total}",
  "permissions": "{can_edit, can_archive, can_delete}"
}

Errores

Estado	Cuándo
400	validation_error, invalid_color
401	Credencial ausente, inválida o expirada
403	feature_not_available, permission_denied, guest_not_allowed
409	duplicate_name — ya existe una etiqueta con este nombre
429	Limitado — encabezado Retry-After presente

curl -sS -X POST 'https://api.dailybot.com/v1/labels/' \
  -H 'X-API-KEY: $DAILYBOT_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"name": "Release", "color": "#4F46E5"}'

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/labels/{label_uuid}/API keyCLI Auth

Obtener una etiqueta

Obtiene una Etiqueta organizacional por UUID, incluyendo conteos de uso y permisos del llamante.

Parámetros de ruta

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

Respuesta

{
  "uuid": "string",
  "name": "string",
  "color": "string",
  "description": "string | null",
  "is_archived": "boolean",
  "usage": "{forms, automations, checkins, total}",
  "created_by": "object | null",
  "last_applied_at": "string (ISO 8601) | null",
  "permissions": "{can_edit, can_archive, can_delete}"
}

Errores

Estado	Cuándo
401	Credencial ausente, inválida o expirada
403	feature_not_available, permission_denied, guest_not_allowed
404	not_found — etiqueta no pertenece a la organización del llamante
429	Limitado — encabezado Retry-After presente

curl -sS 'https://api.dailybot.com/v1/labels/{label_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.

permissions.can_delete es por etiqueta (el llamante puede hard-delete esta Etiqueta). Distinto de can_hard_delete en GET /v1/labels/entitlement/, que es el flag elevado a nivel de organización.

PATCH/v1/labels/{label_uuid}/API keyCLI Auth

Actualizar una etiqueta

Actualización parcial de una Etiqueta (name, color, description, is_archived). Requiere can_edit en la etiqueta.

Parámetros de ruta

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

Cuerpo de la solicitud

{
  "name": "string (optional)",
  "color": "string (optional hex)",
  "description": "string | null (optional)",
  "is_archived": "boolean (optional)"
}

Respuesta

{
  "uuid": "string",
  "name": "string",
  "color": "string",
  "is_archived": "boolean",
  "usage": "{forms, automations, checkins, total}"
}

Errores

Estado	Cuándo
400	validation_error, invalid_color
401	Credencial ausente, inválida o expirada
403	permission_denied
404	not_found
409	duplicate_name
429	Limitado — encabezado Retry-After presente

curl -sS -X PATCH 'https://api.dailybot.com/v1/labels/{label_uuid}/' \
  -H 'X-API-KEY: $DAILYBOT_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"color": "#059669"}'

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.

DELETE/v1/labels/{label_uuid}/API keyCLI Auth

Eliminar permanentemente una etiqueta

Elimina permanentemente una Etiqueta. Requiere rol elevado (can_hard_delete). Devuelve 409 si la etiqueta sigue adjunta a elementos — archiva o desvincula primero.

Parámetros de ruta

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

Errores

Estado	Cuándo
401	Credencial ausente, inválida o expirada
403	permission_denied
404	not_found
409	label_in_use — la etiqueta está adjunta a uno o más elementos
429	Limitado — encabezado Retry-After presente

curl -sS -X DELETE 'https://api.dailybot.com/v1/labels/{label_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.

POST/v1/labels/{label_uuid}/archive/API keyCLI Auth

Archivar una etiqueta

Archiva una Etiqueta (is_archived=true). Idempotente. Las etiquetas archivadas no pueden asignarse de nuevo pero pueden permanecer en elementos existentes.

Parámetros de ruta

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

Respuesta

{
  "uuid": "string",
  "name": "string",
  "is_archived": "true"
}

Errores

Estado	Cuándo
401	Credencial ausente, inválida o expirada
403	permission_denied
404	not_found
429	Limitado — encabezado Retry-After presente

curl -sS -X POST 'https://api.dailybot.com/v1/labels/{label_uuid}/archive/' \
  -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.

Usa PATCH con is_archived=false en el detalle de la etiqueta para restaurar una etiqueta archivada.

GET/v1/labels/{label_uuid}/items/API keyCLI AuthPaginación limit-offset

Listar elementos con una etiqueta

Listado paginado de Formularios, Automatizaciones y Check-ins asociados a una Etiqueta. Consciente de visibilidad — solo devuelve elementos que el llamante puede ver (modal de elementos asociados en Configuración).

Parámetros de ruta

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

Parámetros de consulta

Nombre	Tipo	Requerido	Descripción
type	string	Opcional	Filtra por tipo: forms, automations, checkins.
search	string	Opcional	Búsqueda sin distinción de mayúsculas en el nombre del elemento.
limit	integer	Opcional	Tamaño de página. Por defecto 20, máx. 100.
offset	integer	Opcional	Offset de paginación.

Respuesta

{
  "count": "integer",
  "next": "string | null",
  "previous": "string | null",
  "results": "array<{type, uuid, name, active, archived, assigned_at}>"
}

Errores

Estado	Cuándo
401	Credencial ausente, inválida o expirada
403	feature_not_available, permission_denied
404	not_found
429	Limitado — encabezado Retry-After presente

curl -sS 'https://api.dailybot.com/v1/labels/{label_uuid}/items/?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.

Etiquetas organizacionales

Las Etiquetas de Dailybot son una taxonomía compartida a nivel de organización que puedes adjuntar a Formularios, Automatizaciones (workflows) y Check-ins. Permiten filtrar en listados, gestionar en Configuración y ver elementos asociados. Las Etiquetas requieren que la función esté habilitada para la organización; los usuarios invitados no tienen acceso.

Resumen de producto: /hc/account/organization/labels/.

CLI y Agent Skill: Usa dailybot label … o el sub-skill dailybot-labels (dailybot-cli >= 3.9.0). Ver /es/developers/cli y /es/developers/agent-skill.

Elegibilidad

Llama a GET /v1/labels/entitlement/ antes de construir UI de Etiquetas. La respuesta siempre devuelve flags (nunca bloquea la respuesta):

Campo	Significado
`entitled`	La función está habilitada y el llamante no es invitado
`is_guest`	El llamante es invitado (siempre denegado)
`can_create`	Puede crear etiquetas
`can_manage_all`	Gestión elevada (admins)
`can_hard_delete`	Hard-delete elevado (flag de elegibilidad a nivel org; distinto de `permissions.can_delete` por etiqueta)

Sin función: entitled: false con reason: feature_not_enabled. Invitados: entitled: false con reason: guest_not_allowed.

Forma LabelSummary

Las filas compactas en listados de entidades, detalle de Formularios y respuestas de asignación usan LabelSummary:

{
  "uuid": "label-uuid",
  "name": "Release",
  "color": "#4F46E5",
  "is_archived": false
}

Los objetos completos de /v1/labels/ también exponen usage: {forms, automations, checkins, total}, permissions y campos de auditoría.

Asignar etiquetas

Los endpoints de asignación usan POST (no PUT):

Dominio	Reemplazo en una entidad	Lote
Formularios	`POST /v1/forms/{uuid}/labels/`	`POST /v1/forms/labels/batch/`
Check-ins	`POST /v1/checkins/{uuid}/labels/`	`POST /v1/checkins/labels/batch/`
Automatizaciones	`POST /v1/workflows/{uuid}/labels/`	`POST /v1/workflows/labels/batch/`

Cuerpo de reemplazo: {"label_uuids": ["…", "…"]}. Lote: {"entity_uuids": ["…"], "label_uuids": ["…"], "mode": "add"|"remove"|"replace"}.

Filtrar listados

Param	Notas
`labels`	UUIDs separados por comas (máx. 50). Al menos una de las etiquetas seleccionadas (OR / match-any). Requiere elegibilidad.
`featured`	`true` / `false` — Featured privado del llamante.
`prioritize_featured`	`true` — filas Featured primero.

Si el enriquecimiento del listado no está disponible, los params de enriquecimiento responden 503 con dashboard_enrichment_temporarily_unavailable. Ver /es/developers/errors.

Códigos de error frecuentes

Código	HTTP	Cuándo
`feature_not_available`	403	Función no habilitada
`guest_not_allowed`	403	Invitado
`permission_denied`	403	Rol insuficiente
`duplicate_name`	409	Nombre duplicado
`archived_label`	400	Asignar etiqueta archivada
`label_limit_exceeded`	400	Asignación/lote excedería el límite de Etiquetas por entidad
`invalid_color`	400	Color create/PATCH no es hex válido
`label_in_use`	409	Hard-delete con asignaciones
`not_found`	404	Etiqueta o entidad desconocida

Etiquetas

Elegibilidad de etiquetas

Respuesta

Errores

Probarlo

Listar etiquetas de la organización

Parámetros de consulta

Respuesta

Errores

Probarlo

Crear una etiqueta

Cuerpo de la solicitud

Respuesta

Errores

Probarlo

Obtener una etiqueta

Parámetros de ruta

Respuesta

Errores

Probarlo

Actualizar una etiqueta

Parámetros de ruta

Cuerpo de la solicitud

Respuesta

Errores

Probarlo

Eliminar permanentemente una etiqueta

Parámetros de ruta

Errores

Probarlo

Archivar una etiqueta

Parámetros de ruta

Respuesta

Errores

Probarlo

Listar elementos con una etiqueta

Parámetros de ruta

Parámetros de consulta

Respuesta

Errores

Probarlo

Etiquetas organizacionales

Elegibilidad

Forma LabelSummary

Asignar etiquetas

Filtrar listados

Códigos de error frecuentes

Relacionado