Skip to main content
POST
Log an agent run

Authorizations

Authorization
string
header
required

Your project's secret key (pk_…, without the pub segment). Server-side only — never ship it to a browser. Get it from Settings → Projects in the dashboard.

Body

application/json
kind
string
required

Step kind, e.g. observation, proposal, launch, evaluation, conclusion.

Maximum string length: 64
Example:

"launch"

input

What the step looked at (max 16 KB serialized).

output

What the step produced (max 16 KB serialized).

rationale
string | null
Maximum string length: 4000
goalId
string | null

Must be a goal in this project. Omit for direct communications.

Minimum string length: 1
campaignId
string | null

First-class campaign identity. Required for hosted evaluate, propose, mutate, and approval runs.

Minimum string length: 1
idempotencyKey
string | null

Unique per project. A replay returns the original run with 200.

Required string length: 1 - 128

Response

The original logged run for an idempotent replay.

run
object
required