Seri Qoder CN:Jalankan jadwal

Header permintaan

Header	Diperlukan	Deskripsi
Authorization	Ya	Bearer <PAT>
Content-Type	Tidak	application/json jika body dikirim.
Idempotency-Key	Tidak	Kunci idempotensi opsional untuk permintaan yang tidak aman.

Parameter path

Parameter	Tipe	Diperlukan	Deskripsi
schedule_id	string	Ya	ID Schedule Forward.

Contoh permintaan

curl -s -X POST 'https://api.qoder.com.cn/api/v1/forward/schedules/sched_019f00112233445566778899aabbccdd/run' \
  -H "Authorization: Bearer $QODER_PAT"

Contoh respons

HTTP 200 OK

{
  "id": "srun_019f00112233445566778899aabbccdd",
  "schedule_id": "sched_019f00112233445566778899aabbccdd",
  "identity_id": "idn_019eabc123",
  "template_id": "tmpl_support",
  "session_id": null,
  "status": "pending",
  "trigger_context": {
    "type": "manual"
  },
  "error": null,
  "result_payload": null,
  "push_sink": null,
  "push_status": "skipped",
  "attempt": 1,
  "triggered_at": "2026-06-22T12:00:00Z",
  "started_at": null,
  "completed_at": null,
  "duration_ms": null,
  "created_at": "2026-06-22T12:00:00Z"
}

Bidang respons

Mengembalikan objek Schedule Run yang dibuat.

Kesalahan

HTTP	Tipe	Kode	Pemicu
401	authentication_error	authentication_required	PAT tidak valid atau kedaluwarsa.
404	not_found_error	schedule_not_found	Schedule tidak ada.
409	invalid_request_error	schedule_archived	Schedule diarsipkan.
409	invalid_request_error	schedule_not_active	Schedule dijeda.

Catatan

• Jika Schedule telah mencapai execution.max_concurrent_runs, Forward tetap membuat Run dengan status=skipped dan error.type=concurrency_limit_reached.

• Lakukan polling Get Schedule Run hingga status bernilai completed, failed, atau skipped.

API terkait

• Get schedule run

• List schedule runs