agent

Submit a follow-up message for a run

Send a follow-up message to an existing run. The server transparently routes the message based on the current state of the run (still queued, actively running, or ended). A 200 response means the follow-up was accepted; updated run state can be observed via GET /agent/runs/{runId}.

post/agent/runs/{runId}/followups

Path parameters

runIdstring required

The unique identifier of the run

Request body

messagestring

The follow-up message to send to the run.

mode'normal' | 'plan' | 'orchestrate'

Query mode for an agent run.

  • normal: Standard user query (default).
  • plan: Planning Mode. The agent researches and creates a plan, then waits for approval before execution.
  • orchestrate: Orchestration Mode. The agent proposes an orchestration plan and must not start child agents until approved.

Response

Follow-up accepted

object required

Changes

Changed in 1 of the 2 revisions of this API.10

    • added the optional property auth_url to the response with the 400 status

      response-optional-property-added

    • added the optional property auth_url to the response with the 401 status

      response-optional-property-added

    • added the optional property auth_url to the response with the 403 status

      response-optional-property-added

    • added the optional property auth_url to the response with the 404 status

      response-optional-property-added

    • added the optional property auth_url to the response with the 500 status

      response-optional-property-added

    • added the optional property provider to the response with the 400 status

      response-optional-property-added

    • added the optional property provider to the response with the 401 status

      response-optional-property-added

    • added the optional property provider to the response with the 403 status

      response-optional-property-added

    • added the optional property provider to the response with the 404 status

      response-optional-property-added

    • added the optional property provider to the response with the 500 status

      response-optional-property-added