Saltar al contenido principal
PATCH
cURL
Usa PATCH para actualizaciones parciales. Para cambiar el nombre de un cuestionario, envía solo title o description.
Para actualizar las preguntas, envía el array form_elements completo tal como quieres que quede. Este reemplaza la lista de preguntas anterior. Conserva las preguntas existentes que todavía quieras mostrar.
La API v3 solo admite cuestionarios lineales simples. Rechaza graph, branches, next y las reglas condicionales. La respuesta incluye questionnaire_id. Cuando actualizas un cuestionario published, la API puede crear una nueva versión. Guarda el questionnaire_id devuelto y úsalo en los flujos en lugar de suponer que el id de la URL sigue siendo la versión más reciente.

Autorizaciones

x-api-key
string
header
requerido

La clave de API de tu aplicación, que encontrarás en Developers -> API keys en la Business Console. La clave principal tiene acceso completo. Una clave con nombre puede tener un alcance limitado: ninguno, lectura o escritura por recurso, limitada a algunos flujos o a sesiones aprobadas, a una lista de direcciones IP y a una fecha de caducidad. 401 significa que la clave es incorrecta, se revocó o expiró; 403 significa que no se envió ninguna clave, que la clave no tiene acceso a este recurso o acción, o que la solicitud provino de una dirección fuera de su lista de IP; 404 en una ruta de sesión significa que la sesión está fuera de los flujos o estados de la clave. Una clave sin acceso a contenido multimedia recibe las URL de imágenes, videos y PDF como null, y una clave sin permiso de escritura en sesiones recibe los enlaces y tokens de sesión como null. Consulta https://docs.didit.me/console/api-keys.

Parámetros de ruta

questionnaire_uuid
string<uuid>
requerido

UUID por versión del cuestionario que se va a actualizar.

Cuerpo

application/json

Actualiza los metadatos del cuestionario o reemplaza la lista lineal completa de form_elements.

title
string
description
string | null
languages
string[]
default_language
string
is_active
boolean
status
enum<string>
Opciones disponibles:
draft,
published
form_elements
object[]

Si se proporciona, sustituye por completo la lista lineal de preguntas.

Minimum array length: 1

Respuesta

Cuestionario actualizado. El cuerpo es el estado más reciente de la versión resultante: la versión actualizada en el mismo lugar, o la nueva versión publicada creada cuando enviaste status: "published" sobre una fila publicada (en ese caso, questionnaire_id y version difieren de los que modificaste). El questionnaire_id de la respuesta es el UUID de cada versión; usa questionnaire_group_id si necesitas el identificador estable del grupo.

Detalle completo del cuestionario que devuelven los endpoints GET, POST (crear) y PATCH (actualizar).

questionnaire_id
string<uuid>

Identificador único del cuestionario. Usa este id para hacer referencia al cuestionario desde un flujo o en solicitudes posteriores de actualización o eliminación.

title
string
description
string | null
languages
string[]
default_language
string
is_active
boolean
is_simple_questionnaire
boolean
graph
object

Estructura de grafo con start_node y un mapa de nodos.

sections
object[]

Contenido del cuestionario agrupado en secciones (derivado del grafo).

questionnaire_group_id
string<uuid>

Identificador estable que agrupa todas las versiones del mismo cuestionario.

version
integer
status
enum<string>
Opciones disponibles:
draft,
published
published_at
string<date-time> | null
is_editable
boolean

True cuando el cuestionario aún puede editarse directamente (versiones en borrador).

Última modificación el 1 de noviembre de 2026