Прочитать запросы на согласование и решить их

Согласование — это запрос решения человека, которого ждёт выполнение. Его создаёт узел Требуется одобрение, а также узел AI-модель, чья политика перерасхода просит человека. Операции этой страницы перечисляют запросы и решают их. Консоль показывает те же запросы на Согласования.

Кто читает и кто решает

Чтение запросов требует разрешения management:read. Решение требует management:write, потому что решение позволяет выполнению тратить деньги. Журнал аудита записывает каждое решение.

Ключ читает и решает запросы своего проекта. Запрос другого проекта или несуществующий отвечает 404 с кодом approval_not_found.

Список идёт от новых к старым и читается страница за страницей, как описывает статья Запросы. Отправьте status=pending, чтобы читать только запросы, которые ещё ждут.

Что делает решение

• Тело необязательно. Его reason длиной до 500 символов сохраняется с согласованием и видно в трассировке выполнения.

• Ответ — согласование с новым status и decided_at. Решение, принятое API-ключом, называет ключ в decided_by. Решение, принятое в консоли, называет человека в decided_by_user_id и decided_by_name.

• Запрос не двигает выполнение. Выполнение продолжается в течение минуты: через порт Одобрено после одобрения и через Отклонено после отклонения.

• Запрос от узла модели решается так же. Одобрение позволяет вызову модели продолжиться с новым холдом, а отклонение отказывает в нём с overrun_stopped — статья Согласования говорит, что дальше.

• Slen отправляет событие вебхука approval.decided с решением.

Запрос, который больше нельзя решить

Запрос ждёт до expires_at. Автор узла Требуется одобрение задаёт время на узле, а запрос от узла модели ждёт 24 часа. Когда никто не решил вовремя, запрос в течение минуты становится expired, а approval.decided говорит expired. Дальше всё идёт так же, как после отклонения: из узла Требуется одобрение выполнение выходит через Отклонено, а вызову узла модели отказано с overrun_stopped.

• Запрос, который больше не pending, отвечает 409 с кодом approval_already_decided: его кто-то решил, или его срок истёк.

• Запрос, который ещё pending, когда его время прошло, отвечает 409 с кодом approval_expired. Он сразу закрывается как expired, будто никто не решил, и выполнение идёт дальше так же, как после отклонения.

• Запрос, выполнение которого закончилось и больше не ждёт, отвечает тем же approval_expired. Он закрывается как expired, ничего не продолжается, и событие вебхука не отправляется.

Операции

{
  "data": [
    {
      "approval_id": "74438200973594624",
      "project_id": "74438200973594624",
      "execution_id": "74438200973594624",
      "flow_id": "74438200973594624",
      "node_key": "string",
      "operation_code": "generate_email",
      "note": "string",
      "status": "pending",
      "decided_by": "string",
      "decided_by_user_id": "74438200973594624",
      "decided_by_name": "string",
      "reason": "string",
      "expires_at": "2026-10-02T09:30:00Z",
      "created_at": "2026-10-02T09:30:00Z",
      "decided_at": "2026-10-02T09:30:00Z"
    }
  ],
  "meta": {
    "limit": 1,
    "next_cursor": "string"
  }
}

{
  "reason": "string"
}

{
  "data": {
    "approval_id": "74438200973594624",
    "project_id": "74438200973594624",
    "execution_id": "74438200973594624",
    "flow_id": "74438200973594624",
    "node_key": "string",
    "operation_code": "generate_email",
    "note": "string",
    "status": "pending",
    "decided_by": "string",
    "decided_by_user_id": "74438200973594624",
    "decided_by_name": "string",
    "reason": "string",
    "expires_at": "2026-10-02T09:30:00Z",
    "created_at": "2026-10-02T09:30:00Z",
    "decided_at": "2026-10-02T09:30:00Z"
  }
}

{
  "reason": "string"
}

{
  "data": {
    "approval_id": "74438200973594624",
    "project_id": "74438200973594624",
    "execution_id": "74438200973594624",
    "flow_id": "74438200973594624",
    "node_key": "string",
    "operation_code": "generate_email",
    "note": "string",
    "status": "pending",
    "decided_by": "string",
    "decided_by_user_id": "74438200973594624",
    "decided_by_name": "string",
    "reason": "string",
    "expires_at": "2026-10-02T09:30:00Z",
    "created_at": "2026-10-02T09:30:00Z",
    "decided_at": "2026-10-02T09:30:00Z"
  }
}

Примеры

Прочитать запросы, которые ждут

Одно выполнение ждёт решения у своего узла review. Заметку оставил на узле автор флоу.

curl "https://api.slen.ai/api/v1/approvals?status=pending" \
  -H "Authorization: Bearer $SLEN_API_KEY"

{
  "data": [
    {
      "approval_id": "74443031076798464",
      "project_id": "74438200973594624",
      "execution_id": "74443028719599616",
      "flow_id": "74438623450128384",
      "node_key": "review",
      "operation_code": "generate_email",
      "note": "Check the tone before the email goes out.",
      "status": "pending",
      "decided_by": null,
      "decided_by_user_id": null,
      "decided_by_name": null,
      "reason": null,
      "expires_at": "2026-10-03T09:20:11+00:00",
      "created_at": "2026-10-02T09:20:11+00:00",
      "decided_at": null
    }
  ],
  "meta": {
    "limit": 30,
    "next_cursor": null
  }
}

Одобрить запрос

Ответ — согласование с решением и ключом, который его принял.

curl -X POST https://api.slen.ai/api/v1/approvals/74443031076798464/approve \
  -H "Authorization: Bearer $SLEN_API_KEY"

{
  "data": {
    "approval_id": "74443031076798464",
    "project_id": "74438200973594624",
    "execution_id": "74443028719599616",
    "flow_id": "74438623450128384",
    "node_key": "review",
    "operation_code": "generate_email",
    "note": "Check the tone before the email goes out.",
    "status": "approved",
    "decided_by": "74438344587730944",
    "decided_by_user_id": null,
    "decided_by_name": null,
    "reason": null,
    "expires_at": "2026-10-03T09:20:11+00:00",
    "created_at": "2026-10-02T09:20:11+00:00",
    "decided_at": "2026-10-02T09:31:40+00:00"
  }
}

Отклонить запрос

Причина сохраняется с согласованием. Выполнение выходит из узла через Отклонено.

curl https://api.slen.ai/api/v1/approvals/74443031076798464/reject \
  -H "Authorization: Bearer $SLEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "reason": "The customer asked us not to write again."
  }'

{
  "data": {
    "approval_id": "74443031076798464",
    "project_id": "74438200973594624",
    "execution_id": "74443028719599616",
    "flow_id": "74438623450128384",
    "node_key": "review",
    "operation_code": "generate_email",
    "note": "Check the tone before the email goes out.",
    "status": "rejected",
    "decided_by": "74438344587730944",
    "decided_by_user_id": null,
    "decided_by_name": null,
    "reason": "The customer asked us not to write again.",
    "expires_at": "2026-10-03T09:20:11+00:00",
    "created_at": "2026-10-02T09:20:11+00:00",
    "decided_at": "2026-10-02T09:31:40+00:00"
  }
}

Что читать дальше

• Согласования — те же запросы в консоли.

• Асинхронные запуски и ожидание — чем отвечает выполнение, которое ждёт решения.

• Вебхуки — approval.requested и approval.decided и как они приходят.

• Коды ошибок — что значит каждый код этой страницы и что с ним делать.