Overview
Endpoints
- POSTAnnotate a run
- POSTSave a checkpoint
- POSTMark run as complete
- POSTContinue execution
- POSTMark run as failed
- POSTSend a heartbeat
- POSTRecord an iteration
- POSTSend a log entry
- GETList memory entries
- GETGet a memory value
- POSTSet a memory value
- DELDelete a memory value
- POSTRecord an output
- GETGet run payload
- POSTReport execution progress
- POSTSave a resource snapshot
- POSTReport resource utilization
- POSTSpawn a child run
- GETList run state
- POSTSet run state
- GETGet a state value
- DELDelete a state value
- POSTSend a stream chunk
- POSTRecord a tool call
- POSTReport resource usage
- POSTWait for an external event
SDK
Save a resource snapshot
Saves a point-in-time snapshot of resource utilization.
POST
/
sdk
/
v1
/
runs
/
{runID}
/
resource-snapshot
Save a resource snapshot
curl --request POST \
--url https://api.strait.dev/sdk/v1/runs/{runID}/resource-snapshot \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"cpu_percent": 123,
"memory_limit_mb": 123,
"memory_mb": 123,
"network_rx_bytes": 123,
"network_tx_bytes": 123
}
'{
"cpu_percent": 123,
"created_at": "2023-11-07T05:31:56Z",
"id": "<string>",
"memory_limit_mb": 123,
"memory_mb": 123,
"network_rx_bytes": 123,
"network_tx_bytes": 123,
"run_id": "<string>",
"$schema": "<string>"
}Documentation Index
Fetch the complete documentation index at: https://docs.strait.dev/llms.txt
Use this file to discover all available pages before exploring further.
Authorizations
API key passed as Bearer token
Path Parameters
Body
application/json
Response
OK
A URL to the JSON Schema for this object.
Example:
"https://api.strait.dev/schemas/RunResourceSnapshot.json"
⌘I
Save a resource snapshot
curl --request POST \
--url https://api.strait.dev/sdk/v1/runs/{runID}/resource-snapshot \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"cpu_percent": 123,
"memory_limit_mb": 123,
"memory_mb": 123,
"network_rx_bytes": 123,
"network_tx_bytes": 123
}
'{
"cpu_percent": 123,
"created_at": "2023-11-07T05:31:56Z",
"id": "<string>",
"memory_limit_mb": 123,
"memory_mb": 123,
"network_rx_bytes": 123,
"network_tx_bytes": 123,
"run_id": "<string>",
"$schema": "<string>"
}