Menampilkan semua agen dalam akun saat ini, dengan dukungan pagination dan pengurutan.
Header permintaan
|
Header |
Wajib |
Deskripsi |
|
|
Ya |
|
Parameter kueri
|
Parameter |
Tipe |
Wajib |
Bawaan |
Deskripsi |
|
|
integer |
Tidak |
20 |
Jumlah hasil per halaman, antara 1 hingga 100. |
|
|
string |
Tidak |
|
Arah pengurutan. Bisa berupa |
|
|
string |
Tidak |
- |
Kursor. Kembalikan catatan setelah ID ini. |
|
|
string |
Tidak |
- |
Kursor. Kembalikan catatan sebelum ID ini. |
Lihat Pagination untuk semantik kursor.
Contoh permintaan
curl -X GET "https://api.qoder.com.cn/api/v1/cloud/agents?limit=2&order=desc" \
-H "Authorization: Bearer $QODER_PAT"
Contoh respons
HTTP 200 OK
{
"data": [
{
"type": "agent",
"id": "agent_019eXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
"name": "doc-test-agent",
"description": "",
"model": "ultimate",
"system": "You are a documentation test assistant.",
"instructions": "You are a documentation test assistant.",
"tools": [],
"mcp_servers": [],
"default_environment": "",
"version": 1,
"archived": false,
"archived_at": null,
"created_at": "2026-05-18T15:26:39.61669Z",
"updated_at": "2026-05-18T15:26:39.61669Z"
},
{
"type": "agent",
"id": "agent_019eYYYYYYYYYYYYYYYYYYYYYYYYYYYY",
"name": "test-agent-e2e",
"description": "Agent used for E2E testing.",
"model": "ultimate",
"system": "You are a test assistant.",
"instructions": "You are a test assistant.",
"tools": [],
"mcp_servers": [],
"default_environment": "",
"version": 2,
"archived": false,
"archived_at": null,
"created_at": "2026-05-18T03:04:33.952256Z",
"updated_at": "2026-05-18T03:05:28.023697Z"
}
],
"first_id": "agent_019eXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
"last_id": "agent_019eYYYYYYYYYYYYYYYYYYYYYYYYYYYY",
"has_more": true
}
Bidang respons
|
Bidang |
Tipe |
Deskripsi |
|
|
array |
Array objek agent. |
|
|
string |
ID catatan pertama pada halaman saat ini. |
|
|
string |
ID catatan terakhir pada halaman saat ini. |
|
|
boolean |
Menunjukkan apakah masih ada catatan tambahan yang tersedia. |
Pagination
Pagination maju (halaman berikutnya):
curl "https://api.qoder.com.cn/api/v1/cloud/agents?limit=20&after_id=agent_019eYYYY..." \
-H "Authorization: Bearer $QODER_PAT"
Pagination mundur (halaman sebelumnya):
curl "https://api.qoder.com.cn/api/v1/cloud/agents?limit=20&before_id=agent_019eXXXX..." \
-H "Authorization: Bearer $QODER_PAT"
Error
|
HTTP |
Tipe |
Pemicu |
|
400 |
|
|
|
401 |
|
PAT tidak valid atau telah kedaluwarsa. |
|
403 |
|
Pemanggil tidak memiliki otorisasi untuk operasi ini. |
Lihat Error untuk struktur lengkap respons error.
Catatan
-
Hasil diurutkan berdasarkan waktu pembuatan secara descending secara default (terbaru lebih dulu).
-
Agen yang diarsipkan tidak muncul dalam daftar default.
-
Menggunakan pagination berbasis kursor; pagination berbasis offset tidak didukung.