Список выполнений
GET /v1/executions — последние запуски ваших решений с ответами, действием, причиной и метриками, с фильтрами по решению и статусу и пагинацией через курсор. Входные данные не возвращаются.
GET https://api.dcision.io/v1/executionsВозвращает выполнения рабочего пространства API-ключа, сначала новые: ответы каждого запуска, действие и причину, назначения, статус и код ошибки, метрики. Используйте его, чтобы следить за развёртыванием, выгружать результаты в хранилище данных или калибровать пороги по тому, что произошло на самом деле.
Входные данные никогда не возвращаются
State запуска может содержать персональные данные, поэтому этот эндпоинт никогда его не возвращает. Участники рабочего пространства видят сохранённые входные данные в разделе приложения Выполнения.
Запрос
Параметры запроса
| Параметр | Описание |
|---|---|
limit | Выполнений на странице, от 1 до 100. По умолчанию 20. |
decision | Только выполнения решения с этим slug. |
status | success или error. |
cursor | next_cursor предыдущей страницы, чтобы прочитать следующую. |
Некорректное значение завершается ошибкой 400 INVALID_REQUEST — например, limit=1000 или повреждённый cursor.
curl "https://api.dcision.io/v1/executions?decision=lead-qualification&status=error&limit=50" \
-H "Authorization: Bearer $DCISION_API_KEY"Ответ
{
"data": [
{
"execution_id": "exec_8HsT2kQw9ZyR4vMn1cXe",
"decision": "lead-qualification",
"version": 1,
"source": "api",
"status": "success",
"error_code": null,
"result": { "purchase_intent": 0.9412, "priority": "high", "route": "sales" },
"confidence": { "purchase_intent": 0.8824, "priority": 0.69, "route": 0.85 },
"action": "continue",
"action_reason": { "type": "default" },
"destinations": [
{ "key": "sales_crm", "type": "workflow", "status": "queued", "delivery_id": "dlv_8kJx2mQp4LzN7vR1tY6w" }
],
"metrics": { "latency_ms": 412, "engine": "jev", "model": "jev-1.13.0", "estimated_cost_usd": 0.00001575 },
"created_at": "2026-10-05T14:03:27.512Z"
},
{
"execution_id": "exec_2Lm7Qw4Xz9Tk1Rb6Vn3C",
"decision": "lead-qualification",
"version": 1,
"source": "api",
"status": "error",
"error_code": "INVALID_STATE",
"result": null,
"confidence": null,
"action": null,
"action_reason": null,
"destinations": null,
"metrics": { "latency_ms": 2, "engine": "jev", "model": null, "estimated_cost_usd": 0 },
"created_at": "2026-10-05T14:01:09.880Z"
}
],
"next_cursor": "exec_2Lm7Qw4Xz9Tk1Rb6Vn3C"
}| Поле | Тип | Описание |
|---|---|---|
data | array | Выполнения этой страницы, сначала новые. |
data[].execution_id | string | ID запуска — execution_id, который вернул его ответ. |
data[].decision | string | Slug решения. |
data[].version | integer или null | Запущенная версия; null для запусков в Playground, которые используют черновик. |
data[].source | string | api, webhook (вызов URL вебхука решения) или playground. |
data[].status | string | success или error. |
data[].error_code | string или null | Код ошибки неудачного запуска. |
data[].result | object или null | Ответы с ключами по вопросам. null для неудачных запусков и когда у решения выключен storeOutput. |
data[].confidence | object или null | Уверенность каждого ответа, по тем же правилам, что и result. |
data[].action | string или null | Возвращённое действие; null для неудачных запусков. |
data[].action_reason | object или null | Почему выбрано это действие. |
data[].output | object | Структурированный вывод запуска — есть только если он был собран и у решения включён storeOutput. |
data[].destinations | array или null | Записи назначений, которые вернул запуск, — ответы, ответы LLM и агентов, функции, поставленные в очередь доставки с их delivery_id, пропущенные назначения. null, если ни одно не сработало. Запись в очереди сохраняет статус, который был у неё в момент ответа: ход доставки виден в приложении. |
data[].metrics | object | latency_ms, engine, model и estimated_cost_usd запуска. |
data[].created_at | string | Когда произошёл запуск, ISO 8601. |
next_cursor | string или null | Передайте его как cursor, чтобы прочитать следующую страницу; null на последней странице. |
Неудачные запуски тоже попадают в список — некорректные state, ошибки движка, — чтобы вы видели, что отправляет ваша интеграция. Запуск, на который ответил fallback при ошибке движка, отображается со статусом error и кодом ошибки движка, хотя сам вызов вернул 200.
В списке только выполнения, которые ещё в пределах вашего срока хранения журнала.
Записи назначений могут содержать персональные данные
Само state никогда не возвращается, но destinations хранится в том виде, в каком его вернул запуск, — независимо от настроек storeInput и storeOutput решения: включая параметры функций, сопоставленные из state, готовые ответы, тексты LLM и ответы агентов. Исключение — структурированные выводы: при выключенном storeOutput их объект очищается. Сопоставляйте в параметры только те значения, которые нужны вашему коду.
Пагинация
async function* executions(params = {}) {
let cursor;
do {
const query = new URLSearchParams({ limit: "100", ...params, ...(cursor ? { cursor } : {}) });
const page = await fetch(`https://api.dcision.io/v1/executions?${query}`, {
headers: { Authorization: `Bearer ${process.env.DCISION_API_KEY}` },
}).then((response) => response.json());
yield* page.data;
cursor = page.next_cursor;
} while (cursor);
}
for await (const run of executions({ decision: "voice-banking", status: "success" })) {
console.log(run.created_at, run.result?.intent, run.confidence?.intent, run.action);
}Ошибки
| Статус | Код | Когда |
|---|---|---|
| 400 | INVALID_REQUEST | Некорректный параметр запроса: limit вне диапазона 1–100, неверный формат slug в decision, status или cursor. |
| 401 | INVALID_API_KEY | Ключ отсутствует, имеет неверный формат, неизвестен или отозван. |
| 429 | RATE_LIMITED | Слишком много запросов на чтение в текущую минуту. |
GET /v1/executions использует общее окно rate limit для чтения с GET /v1/me, отдельное от решений. Ключ видит только выполнения своего рабочего пространства.
Аккаунт и использование
GET /v1/me — рабочее пространство, API-ключ и тариф, стоящие за ключом, плюс использование в текущем расчётном периоде. Проверяйте ключ в CI и следите за квотой из кода.
API подпространств
POST, GET, PATCH и DELETE /v1/workspaces — подпространства режима партнёра, по одному на каждого клиента вашего приложения, с адресацией по вашему external_id — и POST /v1/decisions/{slug}/move.