المطورون / الوكلاء

أرشفة وكيل

POST https://api.echonova.ai/v1/agents/{agentId}/archive

تُؤرشف الوكيل: لا تعرضه `GET /v1/agents` إلا إذا فلترت بـ `status=archived`، ويتوقف ويدجت الموقع واختبارات الملعب عنه، ولا يمكن تعديله حتى يُستعاد. تبقى أرقام الهواتف والقنوات المراسلة متصلة وتستمر في الرد؛ افصلها من البوابة. لا يُحذف شيء. أرشفة وكيل مؤرشف تردّ بالرمز 200 دون أي تغيير. مجانًا. يحتاج المفتاح إلى النطاق `agents:write`.

Headers

Authorization string مطلوب

كلمة ⁦Bearer⁩ ثم مسافة ثم مفتاح ⁦API⁩ الذي يبدأ بـ ⁦ek_⁩. أنشئ المفاتيح في البوابة من المطورون، ثم مفاتيح واجهة برمجة التطبيقات.

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

agentId string مطلوب

معرّف الوكيل كما أعادته `GET /v1/agents`.

الاستجابة

200 application/json كل استجابة تستخدم هذا الغلاف.

data object

النتيجة.

success boolean

قيمته ⁦true⁩ عند نجاح الطلب.

statusCode integer

يكرر رمز حالة ⁦HTTP⁩.

errorMessage string or null

قيمته ⁦null⁩ عند النجاح.

الأخطاء

الغلاف نفسه، مع ⁦success⁩ بقيمة ⁦false⁩ و ⁦data⁩ بقيمة ⁦null⁩. كل الأخطاء

POST /v1/agents/{agentId}/archive

curl -X POST "https://api.echonova.ai/v1/agents/{agentId}/archive" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "data": {
    "id": "6650a1b2c3d4e5f6a7b8c9d0",
    "name": "Sales assistant",
    "description": "Answers questions about plans and prices.",
    "status": "active",
    "voice": {
      "id": "6640a1b2c3d4e5f6a7b8c9d0",
      "name": "Huda"
    },
    "dialect": "emirati",
    "llm": {
      "provider": "openai",
      "model": "gpt-4o"
    },
    "channelsCount": 2,
    "sessionsCount": 128,
    "updatedAt": "2026-11-01T10:00:00.000Z",
    "firstMessage": "Hello, how can I help you today?",
    "systemPrompt": "You are a friendly sales assistant for EchoNova.",
    "settings": {
      "recordCalls": true,
      "normalizeNumbers": true
    },
    "knowledgeCount": 3,
    "toolsCount": 2,
    "createdAt": "2026-10-01T10:00:00.000Z"
  },
  "success": true,
  "statusCode": 200,
  "errorMessage": null
}