Passer au contenu principal
PATCH
cURL
Utilisez PATCH pour les mises à jour partielles. Pour renommer un questionnaire, envoyez uniquement title ou description.
Pour mettre à jour les questions, envoyez le tableau form_elements complet souhaité. Cela remplace la liste de questions précédente. Conservez les questions existantes que vous souhaitez toujours afficher.
L’API v3 ne prend en charge que les questionnaires linéaires simples. Elle rejette graph, branches, next et les règles conditionnelles. La réponse inclut questionnaire_id. Lorsque vous mettez à jour un questionnaire published, l’API peut créer une nouvelle version. Récupérez le questionnaire_id renvoyé et utilisez-le dans les workflows, au lieu de supposer que l’identifiant présent dans l’URL correspond toujours à la dernière version.

Autorisations

x-api-key
string
header
requis

La clé API de votre application, issue de Développeurs -> Clés API dans la Business Console. La clé principale dispose d'un accès complet. Une clé nommée peut être restreinte : aucun, lecture ou écriture par ressource, limitée à certains workflows ou aux sessions approuvées, à une liste d'adresses IP et à une date d'expiration. 401 signifie que la clé est incorrecte, révoquée ou expirée ; 403 signifie qu'aucune clé n'a été envoyée, que la clé n'a pas accès à cette ressource ou action, ou que la requête provient d'une adresse hors de sa liste d'IP ; 404 sur une route de session signifie que la session est hors des workflows ou des statuts de la clé. Une clé sans accès aux médias reçoit les URL d'images, de vidéos et de PDF à null, et une clé sans accès en écriture aux sessions reçoit les liens et tokens de session à null. Voir https://docs.didit.me/console/api-keys.

Paramètres de chemin

questionnaire_uuid
string<uuid>
requis

UUID par version du questionnaire à mettre à jour.

Corps

application/json

Mettre à jour les métadonnées du questionnaire ou remplacer la liste linéaire complète form_elements.

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

S'il est fourni, remplace la liste linéaire complète des questions.

Minimum array length: 1

Réponse

Questionnaire mis à jour. Le corps correspond au dernier état de la version résultante — la version mise à jour sur place, ou la version publiée nouvellement créée lorsque vous avez envoyé status: "published" sur une ligne publiée (dans ce cas, questionnaire_id et version diffèrent de ceux que vous avez modifiés). questionnaire_id dans la réponse est l'UUID par version ; utilisez questionnaire_group_id si vous avez besoin de l'identifiant de groupe stable.

Détails complets du questionnaire renvoyés par les endpoints GET, POST (création) et PATCH (mise à jour).

questionnaire_id
string<uuid>

Identifiant unique du questionnaire. Utilisez cet identifiant pour faire référence au questionnaire depuis un workflow ou lors de requêtes ultérieures de mise à jour ou de suppression.

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

Structure en graphe avec start_node et la table de correspondance des nœuds.

sections
object[]

Contenu du questionnaire regroupé en sections (dérivé du graphe).

questionnaire_group_id
string<uuid>

Identifiant stable qui regroupe toutes les versions du même questionnaire.

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

Vrai lorsque le questionnaire peut encore être modifié directement (versions brouillon).

Dernière modification le 7 novembre 2026