Lore
API referenceRuns

Create a run.

Errors return a { message, code } body — see the error reference for the code → SDK exception map.

POST/v1/runs

Creates a run in the API key's project and returns its id. A run groups a stream of events: a client creates one, appends events to it, and packs context from it. The project is taken from the API key, never the body, so a key can only create runs in its own project. The request body is empty.

Authorization

bearerAuth
AuthorizationBearer <token>

API key sent as a bearer token: Authorization: Bearer <key>.

In: header

Response Body

application/json

application/json

application/json

curl -X POST "https://example.com/v1/runs"
{  "run_id": "dded282c-8ebd-44cf-8ba5-9a234973d1ec",  "created_at": "2019-08-24T14:15:22Z"}
{  "message": "string",  "code": "string"}
{  "message": "string",  "code": "string"}