Skip to main content
POST
Requires version 1.1.12 or later of the Archetype platform.

Overview

This endpoint sends a payload to a running serving agent and returns its answer. The body is whatever the blueprint’s source connector accepts, and the answer is whatever its sink produces — the platform passes both through unchanged and wraps the answer in the fields every serving agent reports the same way.

Request

string
required
Serving agent agt_ id to query.
object
required
Whatever the agent’s source connector accepts. The shape belongs to the blueprint, not to this endpoint — see the blueprint’s source connector for what it takes.

Response

string
required
Whether the query produced an answer: completed or failed. Over HTTP the status line already says so, and this is only ever completed; the failed value exists for the /connect frame protocol, where there is no status line.
object
required
The agent’s answer, passed through as it came back. Opaque to the platform — its shape belongs to the blueprint’s connectors.
number
required
Total server-side time, in milliseconds.

Important Notes

  • Start the agent with mode: serving on POST /agents/bundles/{bundle_id}/run. A batch run never answers this endpoint.
  • Both the request body and response are opaque to the platform: their shapes are the blueprint’s source and sink connectors, not this endpoint’s.
  • A 404 covers both an unknown id and one belonging to another organization — the two are indistinguishable by design.
  • Use GET /agents/instances/{agent_id}/connect when you want one open session for many payloads instead of a request per payload.