Langsung ke konten utama
PATCH
cURL
Gunakan PATCH untuk pembaruan parsial. Untuk mengganti nama kuesioner, kirim hanya title atau description.
Untuk memperbarui pertanyaan, kirim seluruh array form_elements yang diinginkan. Array ini menggantikan daftar pertanyaan sebelumnya. Sertakan kembali pertanyaan yang sudah ada dan masih ingin Anda tampilkan.
API v3 hanya mendukung kuesioner linear sederhana. API akan menolak graph, branches, next, dan aturan bersyarat. Respons menyertakan questionnaire_id. Saat Anda memperbarui kuesioner dengan status published, API mungkin membuat versi baru. Simpan questionnaire_id yang dikembalikan dan gunakan di alur kerja, jangan berasumsi bahwa id di URL masih merupakan versi terbaru.

Otorisasi

x-api-key
string
header
wajib

Kunci API aplikasi Anda, dari Developers -> API keys di Business Console. Kunci utama memiliki akses penuh. Kunci bernama dapat diberi cakupan: none, read, atau write per sumber daya, dibatasi pada beberapa alur kerja atau pada sesi yang disetujui, pada daftar alamat IP, dan pada tanggal kedaluwarsa. 401 berarti kuncinya salah, dicabut, atau kedaluwarsa; 403 berarti tidak ada kunci yang dikirimkan, kunci tidak memiliki akses ke sumber daya atau tindakan ini, atau permintaan datang dari alamat di luar daftar IP-nya; 404 pada rute sesi berarti sesi berada di luar alur kerja atau status kunci tersebut. Kunci tanpa akses media menerima URL gambar, video, dan PDF sebagai null, dan kunci tanpa izin tulis sesi menerima tautan sesi dan token sebagai null. Lihat https://docs.didit.me/console/api-keys.

Parameter Path

questionnaire_uuid
string<uuid>
wajib

UUID per versi dari kuesioner yang akan diperbarui.

Body

application/json

Perbarui metadata kuesioner atau ganti seluruh daftar form_elements linear.

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

Jika diberikan, ini menggantikan seluruh daftar pertanyaan linear.

Minimum array length: 1

Respons

Kuesioner diperbarui. Isinya adalah status terbaru dari versi yang dihasilkan — versi yang diperbarui langsung di tempat, atau versi terpublikasi yang baru dibuat saat Anda mengirim status: "published" pada baris yang sudah dipublikasikan (dalam kasus tersebut questionnaire_id dan version berbeda dari yang Anda perbarui). questionnaire_id dalam respons adalah UUID per versi; gunakan questionnaire_group_id jika Anda memerlukan pengidentifikasi grup yang stabil.

Detail kuesioner lengkap yang dikembalikan dari endpoint GET, POST (buat), dan PATCH (perbarui).

questionnaire_id
string<uuid>

Pengenal unik kuesioner. Gunakan id ini saat mereferensikan kuesioner dari alur kerja atau dalam permintaan pembaruan/penghapusan berikutnya.

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

Struktur graf dengan start_node dan peta node.

sections
object[]

Konten kuesioner yang dikelompokkan ke dalam bagian-bagian (berasal dari graf).

questionnaire_group_id
string<uuid>

Pengidentifikasi stabil yang mengelompokkan semua versi dari kuesioner yang sama.

version
integer
status
enum<string>
Opsi yang tersedia:
draft,
published
published_at
string<date-time> | null
is_editable
boolean

True saat kuesioner masih dapat diedit langsung di tempat (versi draf).

Terakhir diubah pada 7 November 2026