Список выполнений

GET /v1/executions — последние запуски ваших решений с ответами, действием, причиной и метриками, с фильтрами по решению и статусу и пагинацией через курсор. Входные данные не возвращаются.

GET https://api.dcision.io/v1/executions

Возвращает выполнения рабочего пространства API-ключа, сначала новые: ответы каждого запуска, действие и причину, назначения, статус и код ошибки, метрики. Используйте его, чтобы следить за развёртыванием, выгружать результаты в хранилище данных или калибровать пороги по тому, что произошло на самом деле.

Входные данные никогда не возвращаются

State запуска может содержать персональные данные, поэтому этот эндпоинт никогда его не возвращает. Участники рабочего пространства видят сохранённые входные данные в разделе приложения Выполнения.

Запрос

Параметры запроса

ПараметрОписание
limitВыполнений на странице, от 1 до 100. По умолчанию 20.
decisionТолько выполнения решения с этим slug.
statussuccess или error.
cursornext_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"

Ответ

200 OK
{
  "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"
}
ПолеТипОписание
dataarrayВыполнения этой страницы, сначала новые.
data[].execution_idstringID запуска — execution_id, который вернул его ответ.
data[].decisionstringSlug решения.
data[].versioninteger или nullЗапущенная версия; null для запусков в Playground, которые используют черновик.
data[].sourcestringapi, webhook (вызов URL вебхука решения) или playground.
data[].statusstringsuccess или error.
data[].error_codestring или nullКод ошибки неудачного запуска.
data[].resultobject или nullОтветы с ключами по вопросам. null для неудачных запусков и когда у решения выключен storeOutput.
data[].confidenceobject или nullУверенность каждого ответа, по тем же правилам, что и result.
data[].actionstring или nullВозвращённое действие; null для неудачных запусков.
data[].action_reasonobject или nullПочему выбрано это действие.
data[].outputobjectСтруктурированный вывод запуска — есть только если он был собран и у решения включён storeOutput.
data[].destinationsarray или nullЗаписи назначений, которые вернул запуск, — ответы, ответы LLM и агентов, функции, поставленные в очередь доставки с их delivery_id, пропущенные назначения. null, если ни одно не сработало. Запись в очереди сохраняет статус, который был у неё в момент ответа: ход доставки виден в приложении.
data[].metricsobjectlatency_ms, engine, model и estimated_cost_usd запуска.
data[].created_atstringКогда произошёл запуск, ISO 8601.
next_cursorstring или 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);
}

Ошибки

СтатусКодКогда
400INVALID_REQUESTНекорректный параметр запроса: limit вне диапазона 1–100, неверный формат slug в decision, status или cursor.
401INVALID_API_KEYКлюч отсутствует, имеет неверный формат, неизвестен или отозван.
429RATE_LIMITEDСлишком много запросов на чтение в текущую минуту.

GET /v1/executions использует общее окно rate limit для чтения с GET /v1/me, отдельное от решений. Ключ видит только выполнения своего рабочего пространства.

На этой странице