Langsung ke konten utama
POST
curl

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.

Header

Content-Type
string

Atur ke application/json saat mengirimkan isi JSON.

Contoh:

"application/json"

Parameter Path

session_id
string<uuid>
wajib

UUID dari sesi Verifikasi Pengguna (KYC). Harus dimiliki oleh aplikasi yang sama dengan kunci API — UUID lintas aplikasi, sesi yang dihapus, dan ID sesi Verifikasi Bisnis (KYB) semuanya mengembalikan 404.

Contoh:

"8c2f3a14-7e9b-4d23-9e83-3f7d5e8a1c6d"

Body

application/json
new_status
enum<string> | null

Label status opsional untuk dicatat pada entri. Menerima nilai status sesi apa pun, peka huruf besar/kecil ("approved" ditolak dengan 400). Mencatat status di sini tidak mengubah status sesi yang sebenarnya — gunakan endpoint update-status untuk itu.

Opsi yang tersedia:
Not Started,
In Progress,
Approved,
Declined,
In Review,
Expired,
Abandoned,
Kyc Expired,
Resubmitted,
Awaiting User
Contoh:

"In Review"

comment
string | null

Catatan teks bebas opsional (tidak ada batas panjang yang diberlakukan). Disimpan apa adanya; sebutan @email tidak diproses pada endpoint ini.

Contoh:

"Flagging for manual document re-check."

Respons

Entri dicatat pada jejak audit sesi. Sesi itu sendiri tidak berubah — status-nya tetap memiliki nilai sebelumnya dan tidak ada webhook yang dikirim. Entri baru juga muncul di bagian atas GET …/reviews/ (dengan actor_display: "Unknown").

user
string

Nama tampilan penulis entri. Selalu "Unknown" untuk entri yang dibuat melalui endpoint ini, karena tidak mencatat atribusi pelaku.

Contoh:

"Unknown"

new_status
enum<string> | null

Label status yang dicatat pada entri, atau null jika tidak ada yang dikirim. Status sesi yang sebenarnya tidak terpengaruh.

Opsi yang tersedia:
Not Started,
In Progress,
Approved,
Declined,
In Review,
Expired,
Abandoned,
Kyc Expired,
Resubmitted,
Awaiting User
Contoh:

"In Review"

comment
string | null

Catatan yang terekam pada entri, atau null jika tidak ada yang dikirim.

Contoh:

"Flagging for manual document re-check."

created_at
string<date-time>

Waktu ketika entri ditulis, ISO 8601 UTC.

Contoh:

"2026-06-12T00:18:44.466537Z"

Terakhir diubah pada 7 November 2026