Skip to navigation
API ReferenceRuns

Record External Run

View as Markdown

Record input and output, optionally deduplicating retries with Idempotency-Key.

Reusing a key with different content returns 409. No execution timing is inferred; the run is ordered by when Sikaru receives it.

Authentication

AuthorizationBearer

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

Path parameters

project_idstringRequired

Headers

Idempotency-Keystring or nullOptional

Request

This endpoint expects an object.
inputstringRequired>=1 character
outputstringRequired
account_idstring or nullOptional
agent_namestringOptional>=1 characterDefaults to Agent

Response

Successful Response

Errors

401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
409
Conflict Error
422
Unprocessable Entity Error