Skip to content
Olivares AI docs

sessions module route (requires sessions:run:write)

POST
/v1/m/sessions/runs/{ref}/input
 
curl --request POST \
  --url https://example.com/v1/m/sessions/runs/example/input \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "attachments": [ "example" ], "line": "example", "message": {}, "text": "example", "work_lease_fence": 1 }'

Sends one input line or message to a live session run.

Authorizations

Section titled “ Authorizations ”

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “ Path Parameters ”
ref
required
string

Path parameter ref.

Header Parameters

Section titled “ Header Parameters ”
X-Olivares-Tenant
string format: uuid

Target tenant id; required when the principal can act in more than one tenant.

Request Body required

Section titled “ Request Body required ”
Media type application/json

One run input. line/message are RAW frames for a Claude stream-json child; text is a turn for a session driven by an owned provider protocol, which refuses a raw frame. Send one form, never both. Omit work_lease_fence for legacy non-work runs; a positive value selects fenced WorkItem control and is accepted with either form, so a work-bound driver run is spoken to through the same fence as its other controls.

object
attachments

Ids of images stored with this session (POST /runs/{ref}/attachments), sent with text as one message. The engine encodes the message for the session’s tool; a tool that takes no images refuses it. Not accepted with line, message or work_lease_fence.

Array<string>
<= 4 items
line
string
>= 1 characters
message
object
key
additional properties
any
text
string
>= 1 characters
work_lease_fence
integer format: int64
>= 1
Example generated 
{
  "attachments": [
    "example"
  ],
  "line": "example",
  "message": {},
  "text": "example",
  "work_lease_fence": 1
}

Responses

Section titled “ Responses ”

202

Section titled “ 202 ”

The input was accepted for the owned child; delivery is not confirmed by this response

Media type application/json
object
accepted
required

Always true; a non-2xx status is the only way this operation reports refusal.

boolean
Example generated 
{
  "accepted": true
}

400

Section titled “ 400 ”

Bad request

Media type application/json
object
Example generated 
{}

401

Section titled “ 401 ”

Unauthenticated

Media type application/json
object
Example generated 
{}

403

Section titled “ 403 ”

Forbidden

Media type application/json
object
Example generated 
{}

404

Section titled “ 404 ”

Not found

Media type application/json
object
Example generated 
{}

409

Section titled “ 409 ”

Conflict / setup required

Media type application/json
object
Example generated 
{}

429

Section titled “ 429 ”

Rate limited

Media type application/json
object
Example generated 
{}

503

Section titled “ 503 ”

The outcome is UNKNOWN: required authority, evidence or store could not be observed, and any external effect may or may not have crossed

Media type application/json
object
code
required

The durable outcome name, e.g. work_input_ambiguous or evidence_unavailable.

string
error
required
object
code
required
string
message
required
string
key
additional properties
any
evidence_ref

Present when the refusal names the field or evidence it could not resolve.

string
verdict
required

The uncertain verdict: the outcome could not be observed.

string
Allowed values: NO_HE_PODIDO_MIRAR
key
additional properties
any
Example 
{
  "verdict": "NO_HE_PODIDO_MIRAR"
}