# Состояние запуска агента

> Требуемое право: text.

`GET https://api.kvantora.ai/v1/agent-runs/{runId}`

Требуемое право: text. Только изнутри запущенного сценария Kvantora Flow: нужен заголовок X-Kvantora-Automation-Run. Запуск виден только ключу, который его создал.

## Параметры

- `runId` (path, обязательный): 
- `X-Kvantora-Automation-Run` (header, обязательный): 
- `Idempotency-Key` (header): Если указан, запуск ищется только среди созданных с этим ключом.

## Пример запроса

```bash
curl --request GET \
  --url "https://api.kvantora.ai/v1/agent-runs/<runId>" \
  --header "Authorization: Bearer $KVANTORA_API_KEY" \
  --header "X-Kvantora-Automation-Run: $AUTOMATION_RUN_ID"
```

## Ответы

- 200: Состояние запуска
- default: Ошибка проверки, прав, лимита или доступности. Код error.code; результат запроса при неизвестном исходе не следует считать отменённым.