AI Coding Assistant Lingma:Hapus agent

Header permintaan

Header	Wajib	Deskripsi
Authorization	Ya	Bearer <PAT>

Parameter path

Parameter	Tipe	Wajib	Deskripsi
agent_id	string	Ya	Pengidentifikasi unik agent.

Badan permintaan

Tidak diperlukan badan permintaan.

Contoh permintaan

curl -X DELETE "https://api.qoder.com.cn/api/v1/cloud/agents/agent_019eXXXX..." \
  -H "Authorization: Bearer $QODER_PAT"

Contoh tanggapan

HTTP 200 OK

{
  "type": "agent",
  "id": "agent_019eXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
  "deleted": true
}

Bidang tanggapan

Bidang	Tipe	Deskripsi
type	string	Selalu "agent".
id	string	Pengidentifikasi unik agent yang dihapus.
deleted	boolean	Selalu true jika berhasil.

Kesalahan

HTTP	Tipe	Pemicu
401	authentication_error	PAT tidak valid atau telah kedaluwarsa.
403	permission_error	Pemanggil tidak memiliki izin untuk menghapus agent ini. Peran admin mungkin diperlukan.
404	not_found_error	Tidak ada agent dengan ID yang diberikan, atau agent tersebut telah dihapus sebelumnya.

Lihat Kesalahan untuk struktur lengkap tanggapan kesalahan.

Catatan

• Penghapusan bersifat permanen dan tidak dapat dikembalikan.

• Untuk menonaktifkan agent sementara, gunakan Archive an agent.

• Menghapus agent yang sudah diarsipkan diperbolehkan.

• Memanggil kembali DELETE pada ID yang sama akan mengembalikan kode 404.

• Beberapa penerapan memerlukan izin admin tambahan (header x-gw-roles: admin); izin yang tidak mencukupi akan mengembalikan kode 403.

Sebelum menghapus

1. Pastikan agent tidak memiliki sesi aktif yang sedang berjalan.

2. Jika Anda tidak yakin apakah penghapusan permanen diperlukan, arsipkan agent terlebih dahulu.

3. Buat cadangan konfigurasi agent melalui endpoint riwayat versi sebelum menghapus.