Skip to main content
POST
Continue Agent Run

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

agent_id
string
required
run_id
string
required

Body

application/x-www-form-urlencoded
tools
string
default:""

JSON string of tool call results to continue the paused run

input
string | null

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_from
string
default:end

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

fork
boolean
default:false

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.

regenerate
boolean
default:false

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_original
boolean | null

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_instructions
string | null

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

session_id
string | null

Session ID for the paused run

user_id
string | null

User identifier for tracking and personalization

stream
boolean
default:true

Enable streaming responses via Server-Sent Events (SSE)

background
boolean
default:false

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

Response

Agent run continued successfully