sessions module route (requires sessions:run:write)
POST
/v1/m/sessions/runs/{ref}/input
const url = 'https://example.com/v1/m/sessions/runs/example/input';const options = { method: 'POST', headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'}, body: '{"line":"example","message":{},"work_lease_fence":1}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url https://example.com/v1/m/sessions/runs/example/input \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "line": "example", "message": {}, "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. Omit work_lease_fence for legacy non-work runs; a positive value selects fenced WorkItem control.
object
line
string
message
object
key
additional properties
any
work_lease_fence
integer format: int64
Example generated
{ "line": "example", "message": {}, "work_lease_fence": 1}Responses
Section titled “ Responses ”OK
Media type application/json
object
Example generated
{}Bad request
Media type application/json
object
Example generated
{}Unauthenticated
Media type application/json
object
Example generated
{}Forbidden
Media type application/json
object
Example generated
{}Not found
Media type application/json
object
Example generated
{}Conflict / setup required
Media type application/json
object
Example generated
{}Rate limited
Media type application/json
object
Example generated
{}