AGagno
Agents

Continue Agent Run

Advance a persisted agent run from its current state. Dispatches on the body shape and the persisted run state (see ADR-003 in specs/agno/features/checkpointing/decisions.md).

Variants:

  • PAUSED + tools provided → apply HITL tool results, resume
  • PAUSED + resolved admin approval (empty tools) → apply resolution, resume
  • RUNNING / ERROR (no unresolved HITL requirements) → resume from last persisted state
  • COMPLETED + new tools → continue with appended messages

Tools Parameter: JSON string containing array of tool execution objects with results. Optional — only required when the persisted run has unresolved HITL requirements.

post/agents/{agent_id}/runs/{run_id}/continue

Request

Path parameters

agent_idstring required
run_idstring required

Request body application/x-www-form-urlencoded

toolsstring

JSON string of tool call results to continue the paused run

inputstring nullable

Optional new user-message text to append to the run before resuming. Use for continuing a COMPLETED run with a follow-up, or adding context to a RUNNING/ERROR resume.

continue_fromstring

Continuation boundary. Use 'end', 'last_user', or a numeric message index.

forkboolean

When true, clone the run with a new run_id before resuming. The original is untouched; the clone becomes a sibling within the same session, with forked_from_run_id set.

regenerateboolean

Sugar: regenerate the last response of this run. Auto-computes continue_from='last_user' to land just after the last user message. Pair with additional_instructions to steer the new output. By default the original response is hidden from history (replaced); pass replace_original=false to keep both the original and the regenerated response visible side by side.

replace_originalboolean nullable

Only valid with regenerate=true. Controls history visibility of the original response; the original run is always retained in storage. Defaults to true: the original is marked REGENERATED and hidden from history so the new response replaces it. Pass false to keep both the original and regenerated responses visible.

additional_instructionsstring nullable

Only valid with regenerate=true: extra guidance appended as a user message before re-generation. Friendly alias for input.

session_idstring nullable

Session ID for the paused run

user_idstring nullable

User identifier for tracking and personalization

streamboolean

Enable streaming responses via Server-Sent Events (SSE)

backgroundboolean

Run continue in background (survives client disconnect). Requires database. Use /resume to reconnect.

Response

Agent run continued successfully

unknown required

Changes

No recorded changes to this operation across all 1 revision of this API.