Vai al contenuto principale
PATCH
cURL
Usa PATCH per gli aggiornamenti parziali. Per rinominare un questionario, invia solo title o description.
Per aggiornare le domande, invia l’array form_elements completo che desideri. Questo sostituisce l’elenco delle domande precedente. Mantieni le domande esistenti che vuoi ancora mostrare.
L’API v3 supporta solo questionari lineari semplici. Rifiuta graph, branches, next e le regole condizionali. La risposta include questionnaire_id. Quando aggiorni un questionario published, l’API può creare una nuova versione. Salva il questionnaire_id restituito e usalo nei workflow, invece di presumere che l’id nell’URL sia ancora l’ultima versione.

Autorizzazioni

x-api-key
string
header
obbligatorio

La chiave API della tua applicazione, da Developers -> API keys nella Business Console. La chiave primaria ha accesso completo. Una chiave con nome può avere un ambito definito: nessuno, lettura o scrittura per risorsa, limitata ad alcuni workflow o a sessioni approvate, a un elenco di indirizzi IP e a una data di scadenza. 401 indica che la chiave è errata, revocata o scaduta; 403 indica che non è stata inviata alcuna chiave, che la chiave non ha accesso a questa risorsa o azione, oppure che la richiesta proviene da un indirizzo non incluso nel suo elenco IP; 404 su una route di sessione indica che la sessione non rientra nei workflow o negli stati previsti dalla chiave. Una chiave senza accesso ai media riceve gli URL di immagini, video e PDF come null, e una chiave senza permessi di scrittura sulle sessioni riceve link e token di sessione come null. Consulta https://docs.didit.me/console/api-keys.

Parametri del percorso

questionnaire_uuid
string<uuid>
obbligatorio

UUID per versione del questionario da aggiornare.

Corpo

application/json

Aggiorna i metadati del questionario o sostituisci l'elenco lineare completo di form_elements.

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

Se fornito, questo sostituisce l'intero elenco lineare delle domande.

Minimum array length: 1

Risposta

Questionario aggiornato. Il corpo è lo stato più recente della versione risultante — la versione aggiornata sul posto, o la versione pubblicata appena creata quando hai inviato status: "published" su una riga pubblicata (in quel caso questionnaire_id e version differiscono da quelli modificati). questionnaire_id nella risposta è l'UUID per versione; usa questionnaire_group_id se hai bisogno dell'identificatore di gruppo stabile.

Dettaglio completo del questionario restituito dagli endpoint GET, POST (creazione) e PATCH (aggiornamento).

questionnaire_id
string<uuid>

Identificativo univoco del questionario. Usa questo id quando fai riferimento al questionario da un workflow o nelle successive richieste di aggiornamento/eliminazione.

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

Struttura a grafo con start_node e mappa dei nodi.

sections
object[]

Contenuto del questionario raggruppato in sezioni (derivato dal grafo).

questionnaire_group_id
string<uuid>

Identificatore stabile che raggruppa tutte le versioni dello stesso questionario.

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

True quando il questionario può ancora essere modificato direttamente (versioni in bozza).

Ultima modifica il 7 novembre 2026