Langsung ke konten utama

​
Submit

POST /api/v1/approval-requests memerlukan requests:create dan idempotency key.
ID/key contoh harus diganti dari katalog/schema. external_id unik per app, 3–120 karakter huruf/angka, titik, garis bawah, titik dua atau minus. documents opsional, harus PDF milik app yang dipetakan ke field file. sign_actor_ids opsional, hanya menunjuk Actor internal sah ketika workflow menerima signing per dokumen. Jalur API memakai digital approval only, tanpa gambar tanda tangan visual. Rilis stale, izin kurang dan runtime belum didukung ditolak.

​
Status

GET /approval-requests mendukung q, status, page, size. GET /approval-requests/{id} memberi detail. Keduanya membutuhkan requests:read dan hanya menampilkan request milik app. Detail mencakup status, version, request_revision, versi form/workflow, data, langkah yang dikunjungi, SLA/waktu dan keputusan. remaining_approval_layers saat aktif dapat bergantung pada Rule, bukan kepastian semua cabang dilewati.

​
Revisi

Ambil GET /approval-requests/{id}/revision-requirements ketika NEEDS_REVISION. PATCH /approval-requests/{id}/revision-draft menyimpan dan POST /approval-requests/{id}/resubmit mengajukan ulang. Gunakan requests:revise, idempotency key dan versi terbaru:
documents opsional. Hanya requester app dengan tugas revisi aktif berwenang yang dapat mengubahnya. Pada konflik, baca ulang dan tinjau perubahan; jangan memaksa versi tebakan. /api/v1/requests pensiun (410 ENDPOINT_RETIRED). Tidak ada endpoint API key untuk approve/reject sebagai manusia.