الانتقال إلى المحتوى الرئيسي
POST
إلغاء الوكيل

إلغاء وكيل

POST /v1/agents/{agentID}/revoke إلغاء هوية وكيل آلة بشكل دائم. هذه عملية لا رجعة فيها والتي:
  1. يضبط حالة الوكيل على "revoked"
  2. يبطل جميع الجلسات النشطة
  3. يحظر جميع استدعاءات الأداة المستقبلية
  4. يمنع استخدام الوكيل في التفويضات الجديدة
الإلغاء دائم ولا يمكن التراجع عنه. إذا كنت بحاجة إلى لتعطيل وكيل، استخدم تعليق نقطة النهاية بدلاً من ذلك. تم إبطال تبقى الوكلاء في النظام لأغراض مسار التدقيق ولكن لا يمكن أعيد تنشيطه.

المصادقة

يتطلب رأس X-API-Key أو رمز Bearer JWT. يتم اشتقاق مساحة العمل من بيانات الاعتماد الموثقة؛ لا ترسل X-Tenant-ID.

الاستجابة

string
الحالة المحدثة، دائمًا "revoked" عند النجاح.
string
معرف وكيل MAIP الذي تم إبطاله.

مثال


متى يتم الإلغاء مقابل التعليق

بعد إلغاء وكيل، لا يزال بإمكانك عرض سجله الكامل عبر GET نقطة النهاية /v1/agents/. يتم الاحتفاظ بسجل الوكيل إلى أجل غير مسمى للامتثال للتدقيق (SOC 2 النوع الثاني، ISO 27001).

التفويضات

X-API-Key
string
header
مطلوب

مفتاح API للمصادقة من جهاز إلى جهاز

معلمات المسار

agentId
string<uuid>
مطلوب

معرف الوكيل

الجسم

application/json
reason
string
مطلوب

سبب الإلغاء المقروء بشريًا

الاستجابة

تم إلغاء الوكيل

id
string<uuid>
agent_type
enum<string>
الخيارات المتاحة:
orchestrator,
worker,
inference,
pipeline,
service,
bot,
llm
display_name
string
Maximum string length: 256
description
string
status
enum<string>
الخيارات المتاحة:
active,
suspended,
revoked
scopes
string[]
metadata
object
trust_score
number<float>
النطاق المطلوب: 0 <= x <= 1
public_key
string

المفتاح العام المشفر بـ Base64

session_count
integer
keys
object[]
created_at
string<date-time>
updated_at
string<date-time>