Formularios · API Reference · Developers

Listar formularios

Devuelve todos los formularios de la organización del llamante (archivados excluidos por defecto). Soporta filtrado por alcance, propietario, búsqueda por nombre, ordenamiento por nombre/fecha/total de respuestas, rangos de fecha e inclusión opcional de preguntas. Las capacidades — edición, visibilidad de respuestas, cambios de estado — están gobernadas por los permisos del formulario; el propietario y los administradores siempre tienen acceso completo.

{
  "count": "integer",
  "next": "string | null",
  "previous": "string | null",
  "results": "array<{ uuid, name, is_active, collect_responses_anonymously, privacy, shortcut, start_on, end_on, is_archived, workflow_enabled, approval_flow_enabled, created_at, questions? }>"
}

curl -sS 'https://api.dailybot.com/v1/forms/?filter=workflow&order=alphabetical&is_ascend=true' \
  -H 'X-API-KEY: $DAILYBOT_API_KEY'

• Cuando include=questions está configurado, cada objeto de formulario incluye un array questions con UUID, label, type, flag required y options de cada pregunta.
• Obsoleto: filter=me — usa owner_user_ids con tu propio UUID de usuario. Los clientes legacy siguen funcionando: me aún resuelve al alcance del propietario del llamante y se intersecta con cualquier owner_user_ids explícito. El alcance me en endpoints de respuestas de formulario no está relacionado y NO está obsoleto. Tanto filter=me como available_on_list_view se aceptan indefinidamente; la remoción se anunciará como una entrada de changelog separada con su propia ventana de migración.
• Obsoleto: available_on_list_view — todavía aceptado en POST /v1/forms/create/ y PATCH /v1/forms/{uuid}/config/ pero ignorado del lado del servidor. La visibilidad en la lista ahora es organizacional. Para ocultar un formulario, archívelo.

Listar propietarios de formularios

Selector paginado y buscable de miembros de la organización que poseen al menos un formulario no archivado. Solo aparecen miembros activos y aprobados. Ordenado por full_name ascendente. Diseñado para selectores de UI: una organización de 1000 miembros devuelve solo sus (típicamente pocos) propietarios de formularios, no todo el directorio.

{
  "count": "integer",
  "next": "string | null",
  "previous": "string | null",
  "results": "array<{ uuid, full_name, image, role, email (conditional — present only for admin/manager/team-admin-scoped callers) }>"
}

curl -sS 'https://api.dailybot.com/v1/forms/form-owners/?search=serg&limit=20' \
  -H 'X-API-KEY: $DAILYBOT_API_KEY'

• Los emails de miembros están ocultos en los payloads del selector. El campo email aparece SOLO cuando el llamante tiene visibilidad de email — admins de organización, managers y admins de equipo. Los llamantes con alcance de miembro reciben filas sin la clave email (omitida, nunca null). Las API keys heredan el rol del propietario de la clave. search aún coincide con el email del lado del servidor para todos, pero el valor nunca se devuelve a llamantes sin visibilidad.
• El campo role contiene el slug del rol organizacional: ADMIN_ORG, MANAGER, ADMIN, MEMBER o GUEST.

Obtener un formulario

Obtiene un formulario por UUID. La puerta de lectura es membresía organizacional — cualquier miembro autenticado de la organización puede leer cualquier formulario. Los campos privacy y available_on_list_view no afectan quién puede leer el formulario; las capacidades como editar, ver respuestas y cambiar estados de workflow están gobernadas por los permisos por alcance del formulario (el propietario y los admins siempre tienen acceso completo).

{
  "uuid": "string (uuid)",
  "name": "string",
  "is_active": "boolean",
  "collect_responses_anonymously": "boolean",
  "privacy": "string",
  "questions": "array",
  "workflow": "object",
  "created_at": "string (ISO 8601)"
}

curl -sS -X GET 'https://api.dailybot.com/v1/forms/{uuid}/' -H 'X-API-KEY: $DAILYBOT_API_KEY'

• La puerta de lectura del detalle es la membresía organizacional. El campo privacy refleja el alcance de envío del formulario (OWNER, TEAM, EVERYONE), no quién puede leer la definición del formulario. El campo available_on_list_view está obsoleto y no tiene efecto — todos los formularios de la organización ahora aparecen en el endpoint de lista.

Listar respuestas de un formulario

Lista paginada de respuestas del formulario. Por defecto devuelve solo las respuestas del llamante. Con all=true o cualquier filtro avanzado (submission_sources, submitter_user_ids, flow_status), devuelve todas las respuestas y requiere permiso VIEW_REPORTS. Soporta búsqueda de texto completo, filtrado por origen de envío, estado de workflow, estado de aprobación, rangos de fecha y ordenamiento.

{
  "count": "integer",
  "next": "string | null",
  "previous": "string | null",
  "results": "array<{ uuid, user, is_dailybot_bot, is_guest_user, is_anonymous, guest_user, submission_source, flow_status, current_state, content, response_completed, has_issue, created_at, updated_at }>"
}

curl -sS 'https://api.dailybot.com/v1/forms/{uuid}/responses/?all=true&submission_sources=automation,public&order=recent' \
  -H 'X-API-KEY: $DAILYBOT_API_KEY'

• Todos los filtros se componen con AND entre grupos y OR dentro de cada grupo. Ejemplo: submission_sources=member,automation AND flow_status=pending devuelve respuestas de miembros O automación que están pendientes de aprobación.
• Usar cualquier filtro avanzado (submission_sources, submitter_user_ids, flow_status) implica automáticamente all=true y requiere permiso VIEW_REPORTS.

Obtener una respuesta de formulario

Obtiene una respuesta de formulario identificada por uuid. Devuelve current_state, allowed_transitions y content.

{
  "uuid": "string (uuid)",
  "form": "string (uuid)",
  "content": "array",
  "current_state": "string",
  "allowed_transitions": "array<string>",
  "response_completed": "boolean",
  "has_issue": "boolean",
  "blockers_status": "string | null",
  "is_anonymous": "boolean",
  "is_dailybot_bot": "boolean",
  "is_guest_user": "boolean",
  "guest_user": "object | null — { full_name, email }",
  "submission_source": "string | null",
  "flow_status": "string | null — approval status: approved, denied, or null (pending/no flow)",
  "created_at": "string (ISO 8601)",
  "updated_at": "string (ISO 8601)"
}

curl -sS -X GET 'https://api.dailybot.com/v1/forms/{uuid}/responses/{response_uuid}/' -H 'X-API-KEY: $DAILYBOT_API_KEY'