Consume AI Instruction
POST/api/support/agent/ai/instructions/:instruction/consume
The AI agent takes an instruction: stamps consumed_at. Exactly once — a second consume is refused with a 409 (error: already_consumed) carrying the instruction as it is now, so a runner that crashes and retries never acts on the same instruction twice.
support:writeGrant this scope to your token under Settings → Developer → Personal Access Tokens.
Path parameters
instruction(integer) — the instruction id from Get AI Control Feed.
No request body. The response is the consumed instruction (fields as in Send Instruction to AI Agent).
Authentication: Bearer token with the support:write scope belonging to the AI agent's own account — any other caller, including support admins, gets a 403. No tenant context — this endpoint is central.
Request
Responses
- 200
- 401
- 403
- 404
- 409
- 422
- 429
OK
Response Headers
Unauthorized
Response Headers
Forbidden
Response Headers
Not Found
Response Headers
Conflict
Response Headers
Validation failed — the body is a field → messages map (Laravel shape) or the platform envelope with a stable machine-readable code. Fix the payload and resubmit.
Rate limited — platform limit is 1,000 requests/min; individual tokens may carry lower limits. Honor the Retry-After header before retrying. See the Rate Limits guide.