> ## Documentation Index > Fetch the complete documentation index at: https://docs.didit.me/llms.txt > Use this file to discover all available pages before exploring further. # Actualitzar qüestionari API: editar formulari KYC > Edita un qüestionari KYC de Didit: canvia el nom, substitueix les preguntes ordenades i actualitza les etiquetes multiidioma. Pagament per crida. Prompt de l'API per actualitzar qüestionaris Copia el prompt al porta-retalls \

\`Update a simple Didit questionnaire through the Management API.

Endpoint:
PATCH https://verification.didit.me/v3/questionnaires/{questionnaire_uuid}/

Authentication:
Use the x-api-key header with my Didit API key.

Requirements:
\- Use PATCH and include only the fields I want to change.
\- To rename the questionnaire, send title or description only.
\- To change questions, send the full desired form_elements array. This replaces the existing question list.
\- Do not send graph, branches, next, required_if, or conditional logic.
\- Keep languages consistent with the questionnaire. Include en labels for every form element.
\- Capture the questionnaire_id returned by the response because published updates may return a new version id.

Example metadata update body:
\{
"title": "Updated Customer Onboarding"
}

Example full question replacement body:
\{
"form_elements": [
\{
  "id": "occupation",
  "element_type": "short_text",
  "label": { "en": "What is your occupation?" },
  "is_required": true
},
\{
  "id": "source_of_funds",
  "element_type": "multiple_choice",
  "label": { "en": "Source of funds" },
  "options": [
    \{ "value": "employment", "label": { "en": "Employment" } },
    \{ "value": "business", "label": { "en": "Business" } }
  ]
}
]
}

Build the API call, handle validation errors, and return the latest questionnaire_id from the response.`

\
Enganxa a Fes servir `PATCH` per a les actualitzacions parcials. Per canviar el nom d'un qüestionari, envia només `title` o `description`.```json theme={null} { "title": "Updated Customer Onboarding" } ```Per actualitzar les preguntes, envia la matriu `form_elements` completa que vulguis. Això substitueix la llista de preguntes anterior. Mantén les preguntes existents que encara vulguis mostrar.```json theme={null} { "form_elements": [ { "id": "occupation", "element_type": "short_text", "label": { "en": "What is your occupation?" }, "is_required": true }, { "id": "source_of_funds", "element_type": "multiple_choice", "label": { "en": "Source of funds" }, "options": [ { "value": "employment", "label": { "en": "Employment" } }, { "value": "business", "label": { "en": "Business" } } ] } ] } ```L'API v3 només admet qüestionaris lineals simples. Rebutja `graph`, `branches`, `next` i les regles condicionals.La resposta inclou `questionnaire_id`. Quan actualitzes un qüestionari `published`, l'API pot crear una nova versió. Captura el `questionnaire_id` retornat i fes-lo servir als fluxos de treball en lloc de suposar que l'id de la URL encara és la versió més recent. ## OpenAPI ````yaml ca/openapi-25.json PATCH /v3/questionnaires/{questionnaire_uuid}/ openapi: 3.0.0 info: version: 3.0.0 title: Didit Verification API description: API de verificació d'identitat. Autentica't amb la capçalera x-api-key. servers: - url: https://verification.didit.me security: [] tags: [] paths: /v3/questionnaires/{questionnaire_uuid}/: patch: tags: - Questionnaires summary: Actualitza el qüestionari description: >- Actualitza un qüestionari. La gestió de versions depèn del camp `status` que enviïs i de l'estat actual de la versió: (1) sense `status` en una versió **publicada** → la versió publicada s'actualitza directament (mateix `questionnaire_id`, mateixa `version`); (2) sense `status` en un **esborrany** → l'esborrany s'actualitza i es publica immediatament; (3) `status: "published"` en una versió **publicada** → es crea una NOVA versió publicada sota el mateix `questionnaire_group_id` (nou `questionnaire_id`, `version` + 1) i es retorna, i qualsevol esborrany existent al grup se suprimeix; (4) `status: "draft"` manté un esborrany com a esborrany (desat automàtic), però es rebutja amb 400 en una versió publicada (`"Cannot revert a published version to draft."`). operationId: update_questionnaire parameters: - name: questionnaire_uuid in: path required: true schema: type: string format: uuid description: UUID per versió del qüestionari que s'actualitzarà. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/SimpleQuestionnaireUpdateRequest' examples: Rename: summary: Reanomenar un qüestionari value: title: Updated Customer Onboarding Replace questions: summary: Substitueix la llista lineal completa de preguntes value: form_elements: - id: occupation element_type: short_text label: en: What is your occupation? is_required: true - id: source_of_funds element_type: multiple_choice label: en: Source of funds options: - value: employment label: en: Employment - value: business label: en: Business responses: '200': description: >- Qüestionari actualitzat. El cos és l'últim estat de la versió resultant — la versió actualitzada in situ, o la versió publicada creada de nou quan has enviat `status: "published"` en una fila publicada (en aquest cas `questionnaire_id` i `version` difereixen dels que has modificat). El `questionnaire_id` de la resposta és l'UUID per versió; utilitza `questionnaire_group_id` si necessites l'identificador de grup estable. content: application/json: schema: $ref: '#/components/schemas/QuestionnaireDetail' '400': description: >- Error de validació: `element_type` desconegut, falta una traducció, camps condicionals/de bifurcació no admesos, falta `en` a `languages`, `default_language` no és a `languages`, opció sense etiqueta, enviament d'un `graph` en brut o `status: "draft"` en una versió publicada (`"Cannot revert a published version to draft."`). El cos de la resposta és un error de validació de DRF indexat pel nom del camp. '403': description: Falta la clau d'API o no és vàlida. content: application/json: examples: Invalid token: value: detail: You do not have permission to perform this action. '404': description: >- No existeix cap qüestionari amb aquest `questionnaire_uuid` per a l'aplicació autenticada. '415': description: 'Tipus de mitjà no admès. Defineix `Content-Type: application/json`.' '429': description: >- S'ha superat el límit de freqüència. Reintenta amb un retrocés exponencial. '500': description: Error inesperat del servidor. Es pot reintentar amb seguretat. security: - ApiKeyAuth: [] x-codeSamples: - lang: curl label: cURL source: >- curl -X PATCH 'https://verification.didit.me/v3/questionnaires/11111111-2222-3333-4444-555555555555/' \ -H 'x-api-key: YOUR_API_KEY' \ -H 'Content-Type: application/json' \ -d '{"title": "Updated Customer Onboarding"}' - lang: python label: Python source: |- from didit import Didit # Reads DIDIT_API_KEY. client = Didit() result = client.questionnaires.update( "11111111-2222-3333-4444-555555555555", title="Updated Customer Onboarding", ) print(result) - lang: javascript label: Node.js source: >- import Didit from "@didit-protocol/sdk-node"; // Reads DIDIT_API_KEY. const didit = new Didit(); const result = await didit.questionnaires.update("11111111-2222-3333-4444-555555555555", { title: "Updated Customer Onboarding", }); console.log(result); - lang: go label: Go source: "ctx := context.Background()\n// Reads DIDIT_API_KEY.\nclient := didit.NewClient()\n\nresult, err := client.Questionnaires.Update(ctx, \"11111111-2222-3333-4444-555555555555\", didit.SimpleQuestionnaireUpdateRequest{\n\tTitle: didit.String(\"Updated Customer Onboarding\"),\n})\nif err != nil {\n\tlog.Fatal(err)\n}\nfmt.Printf(\"%+v\\n\", result)" - lang: java label: Java source: >- import me.didit.Didit; import me.didit.types.SimpleQuestionnaireUpdateRequest; // Reads DIDIT_API_KEY. Didit client = new Didit(); var result = client.questionnaires().update("11111111-2222-3333-4444-555555555555", SimpleQuestionnaireUpdateRequest.builder() .title("Updated Customer Onboarding") .build()); System.out.println(result); - lang: php label: PHP source: >- questionnaires->update('11111111-2222-3333-4444-555555555555', [ 'title' => 'Updated Customer Onboarding', ]); print_r($result->toArray()); - lang: ruby label: Ruby source: |- require "didit" # Reads DIDIT_API_KEY. didit = Didit::Client.new result = didit.questionnaires.update( "11111111-2222-3333-4444-555555555555", title: "Updated Customer Onboarding" ) puts result.to_h - lang: csharp label: .NET source: >- using System; using System.Text.Json; using Didit; // Reads DIDIT_API_KEY. using var client = new DiditClient(); var result = await client.Questionnaires.UpdateAsync("11111111-2222-3333-4444-555555555555", new SimpleQuestionnaireUpdateRequest { Title = "Updated Customer Onboarding", }); Console.WriteLine(JsonSerializer.Serialize(result)); components: schemas: SimpleQuestionnaireUpdateRequest: type: object description: >- Actualitza les metadades del qüestionari o substitueix la llista lineal completa de `form_elements`. properties: title: type: string description: type: string nullable: true languages: type: array items: type: string default_language: type: string is_active: type: boolean status: type: string enum: - draft - published form_elements: type: array minItems: 1 description: >- Si es proporciona, això substitueix la llista lineal completa de preguntes. items: $ref: '#/components/schemas/SimpleQuestionnaireElement' QuestionnaireDetail: type: object description: >- Detall complet del qüestionari retornat des dels endpoints GET, POST (creació) i PATCH (actualització). properties: questionnaire_id: type: string format: uuid description: >- Identificador únic del qüestionari. Utilitza aquest id en fer referència al qüestionari des d'un flux de treball o en sol·licituds posteriors d'actualització o supressió. title: type: string description: type: string nullable: true languages: type: array items: type: string default_language: type: string is_active: type: boolean is_simple_questionnaire: type: boolean graph: type: object description: Estructura del graf amb start_node i mapa de nodes. sections: type: array description: Contingut del qüestionari agrupat en seccions (derivat del graf). items: type: object questionnaire_group_id: type: string format: uuid description: >- Identificador estable que agrupa totes les versions del mateix qüestionari. version: type: integer status: type: string enum: - draft - published published_at: type: string format: date-time nullable: true is_editable: type: boolean description: >- Cert quan el qüestionari encara es pot editar in situ (versions en esborrany). SimpleQuestionnaireElement: type: object required: - element_type - label properties: id: type: string description: >- ID opcional i estable de la pregunta. Si s'omet, l'API genera `q1`, `q2`, etc. Fes servir lletres minúscules, números i guions baixos per millorar la llegibilitat. example: source_of_funds element_type: type: string description: >- Tipus de pregunta. L'API accepta aquests valors en minúscules i els seus equivalents en majúscules. enum: - short_text - long_text - dropdown - single_choice - multiple_choice - number - image - file_upload - time - email - address - phone - country - date_picker - consent - section_header - separator - heading - paragraph label: type: object description: >- Etiqueta de la pregunta per codi d'idioma, per exemple `{ "en": "Source of funds" }`. additionalProperties: type: string description: type: object nullable: true additionalProperties: type: string placeholder: type: object nullable: true additionalProperties: type: string is_required: type: boolean default: false options: type: array description: >- Utilitza per a `dropdown`, `single_choice` i `multiple_choice`. Si s'omet `value`, l'API en genera un a partir de l'etiqueta de l'opció. items: type: object required: - label properties: value: type: string label: type: object additionalProperties: type: string max_files: type: integer minimum: 1 maximum: 5 description: Utilitza amb `file_upload` o `image`. validation: type: object nullable: true description: >- Validació de format opcional per a `short_text`, `long_text` o `number`. S'aplica mentre l'usuari emplena el camp (no pot continuar fins que sigui vàlid) i l'API la torna a comprovar en enviar-lo. properties: pattern: type: string description: >- Expressió regular (subconjunt ECMA-262) amb la qual el valor ha de coincidir completament. Per a `short_text` i `long_text`. No afegeixis àncores ^/$; es fa coincidir el valor sencer. min_length: type: integer minimum: 0 description: Nombre mínim de caràcters. Per a `short_text` i `long_text`. max_length: type: integer minimum: 0 description: Nombre màxim de caràcters. Per a `short_text` i `long_text`. min: type: number description: Valor numèric mínim. Per a `number`. max: type: number description: Valor numèric màxim. Per a `number`. error_message: type: object description: >- Missatge traduït que es mostra quan la validació falla, indexat pel codi d'idioma. additionalProperties: type: string securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- La clau d'API de la teva aplicació, des de Developers -> API keys a la Business Console. La clau primària té accés complet. Una clau amb nom pot tenir l'abast limitat: cap, lectura o escriptura per recurs, limitada a determinats fluxos de treball o a sessions aprovades, a una llista d'adreces IP i a una data de caducitat. 401 significa que la clau és incorrecta, revocada o caducada; 403 significa que no s'ha enviat cap clau, que la clau no té accés a aquest recurs o acció, o que la sol·licitud prové d'una adreça fora de la seva llista d'IP; 404 en una ruta de sessió significa que la sessió està fora dels fluxos de treball o estats de la clau. Una clau sense accés a fitxers multimèdia rep els URL d'imatge, vídeo i PDF com a null, i una clau sense permís d'escriptura de sessions rep els enllaços de sessió i els tokens com a null. Consulta https://docs.didit.me/console/api-keys. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.