---
title: "Override HITL request"
method: POST
path: "/api/v1/hitl/queue/{id}/override"
tags: ["HITL"]
---

# Override HITL request

`POST /api/v1/hitl/queue/{id}/override`

## Request

- Base URL: `https://agent.getaxonflow.com`
- URL: `https://agent.getaxonflow.com/api/v1/hitl/queue/{id}/override`
- Auth: none declared. Required headers: `Authorization`
- TypeScript: <https://skmtc.dev/getaxonflow/apis/axonflow-agent-api/docs/api/v1/hitl/queue/:id/override/post.ts> (a function with typed inputs; its response is checked against the schema)

Record an authorized override of a pending request — the caller takes
responsibility for letting the action proceed outside the normal
approve/reject flow. Requires a justification for the audit trail.

## Path parameters

- `id` string, uuid, required

## Headers

- `Authorization` string, required

## Request body

- object
  - `justification` string: Required by the service — missing justification returns 400
  - `authorized_by_id` string
  - `authorized_by_email` string
  - `authorized_by_role` string

## Response `200`

Request overridden

- object
  - `success` boolean
  - `data` object
    - `status` string

## Other responses

- `400`: Invalid request ID/JSON, or missing justification
- `404`: Request not found
- `409`: Conflict - another reviewer decided this request first (lost race). Also returned when the entry is a Workflow Control Plane step-gate MIRROR (`request_type: "wcp_step_gate"`). Those are resolved on the workflow plane - `POST /api/v1/workflows/{workflow_id}/steps/{step_id}/approve|reject` - and actioning one here would flip a status and release nothing, leaving the workflow paused. **This arm fires on a row that IS pending**, unlike the state conflict above; the response body names the route that works. Mirrors are excluded from this queue's default listing, so a client reaches this only by acting on an id obtained another way (#3408).

---

[API](https://skmtc.dev/getaxonflow/apis/axonflow-agent-api.md) - [All operations](https://skmtc.dev/getaxonflow/apis/axonflow-agent-api/llms.txt) - [OpenAPI document](https://skmtc.dev/getaxonflow/apis/axonflow-agent-api/revisions/34d30fcb7fa1?raw)