Saved agents

Save an agent.

A harness with its model, effort, instructions, skills and connections, to start sessions from by sending its id as agent. Skills are fetched and pinned when the agent is saved (a GitHub source to its commit, any other to its content), and every session from the agent loads exactly that pin. A field this route does not take is 400 UNKNOWN_FIELD; defaults and connection_refs are 400 FIELD_REMOVED. A refused body is 422 with a code, and per-field fields where the catalog does not support a choice (UNSUPPORTED_PROFILE, with field codes such as UNKNOWN_MODEL and INVALID_EFFORT).

post/o/{org}/agents

Request

  • Base URL: https://api.prix.dev
  • URL: https://api.prix.dev/o/{org}/agents
  • Auth: HTTP bearer

Headers

Idempotency-Keystring

Optional for an API key. A retry with the same key and body returns the agent the key first saved; the same key with another body is 409 IDEMPOTENCY_CONFLICT. 1–128 characters.

Request body

namestring required
descriptionstring
harness'claude' | 'codex' | 'opencode' required

Launch-boundary managed harnesses.

modelstring

A model id GET /o/{org}/agents/available lists for the harness. Omitted: the harness's first model.

effortstring

One of the model's effort levels.

instructionsstring

At most 16 KiB.

connectionsstring[]

Ids or names of your own connections (GET /me/connections), as on session create.

Response

The saved agent.

visibility'private' | 'org'

Private by default; org makes the agent usable by current org members.

idstring uuid required
namestring required
descriptionstring
harness'claude' | 'codex' | 'opencode' required

Launch-boundary managed harnesses.

modelstring required
effortstring
instructionsstring
created_atstring date-time required
updated_atstring date-time required

Changes

No recorded changes to this operation across all 2 revisions of this API.