---
title: "Update Execution State"
method: PATCH
path: "/api/internal/conversations/{conversation_id}/execution-state"
tags: ["execution_state"]
---

# Update Execution State

`PATCH /api/internal/conversations/{conversation_id}/execution-state`

## Request

- Base URL: `https://api.tintin-x.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.tintin-x.com/api/internal/conversations/{conversation_id}/execution-state`
- Auth: none declared

Update execution state flags for a conversation.

Called by the agent runtime to:
- Set agent_busy=True when starting execution
- Set agent_busy=False when finishing (also clears interrupt_requested)
- Update status_text with what the agent is currently doing

Broadcasts an agent_execution_state event via Redis so the frontend
receives real-time updates through the chat WebSocket.

## Path parameters

- `conversation_id` string, uuid, required

## Request body

- ExecutionStateUpdate
  - `agent_busy` boolean, nullable
  - `interrupt_requested` boolean, nullable
  - `status_text` string, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/tintin-x/apis/tintin-api.md) · [All operations](https://skmtc.dev/tintin-x/apis/tintin-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tintin-x/apis/tintin-api/revisions/8839a8d0a66c?raw)