curl "https://console.rotastellar.com/api/deployments/dep-456/events?limit=50" \
-H "Cookie: session=..."
{
"events": [
{
"id": "evt-001",
"event_type": "job.accepted",
"step_id": null,
"payload": {
"preset": "onboard-ml-inference",
"category": "ml-inference",
"steps": 4
},
"event_timestamp": "2026-03-07T12:00:00Z",
"created_at": "2026-03-07T12:00:01Z"
},
{
"id": "evt-002",
"event_type": "placement.decided",
"step_id": "capture",
"payload": {
"location": "onboard",
"reason": "preset_defined"
},
"event_timestamp": "2026-03-07T12:00:00Z",
"created_at": "2026-03-07T12:00:01Z"
}
],
"total": 24,
"offset": 0,
"limit": 50
}
Deployments
Deployment Events
Get and report execution events for a deployment
GET
/
api
/
deployments
/
{id}
/
events
curl "https://console.rotastellar.com/api/deployments/dep-456/events?limit=50" \
-H "Cookie: session=..."
{
"events": [
{
"id": "evt-001",
"event_type": "job.accepted",
"step_id": null,
"payload": {
"preset": "onboard-ml-inference",
"category": "ml-inference",
"steps": 4
},
"event_timestamp": "2026-03-07T12:00:00Z",
"created_at": "2026-03-07T12:00:01Z"
},
{
"id": "evt-002",
"event_type": "placement.decided",
"step_id": "capture",
"payload": {
"location": "onboard",
"reason": "preset_defined"
},
"event_timestamp": "2026-03-07T12:00:00Z",
"created_at": "2026-03-07T12:00:01Z"
}
],
"total": 24,
"offset": 0,
"limit": 50
}
Base URL:
https://console.rotastellar.comList Events
Retrieve execution events for a deployment, ordered chronologically.GET /api/deployments/{id}/events
curl "https://console.rotastellar.com/api/deployments/dep-456/events?limit=50" \
-H "Cookie: session=..."
{
"events": [
{
"id": "evt-001",
"event_type": "job.accepted",
"step_id": null,
"payload": {
"preset": "onboard-ml-inference",
"category": "ml-inference",
"steps": 4
},
"event_timestamp": "2026-03-07T12:00:00Z",
"created_at": "2026-03-07T12:00:01Z"
},
{
"id": "evt-002",
"event_type": "placement.decided",
"step_id": "capture",
"payload": {
"location": "onboard",
"reason": "preset_defined"
},
"event_timestamp": "2026-03-07T12:00:00Z",
"created_at": "2026-03-07T12:00:01Z"
}
],
"total": 24,
"offset": 0,
"limit": 50
}
Report Event
Agents use this endpoint to report execution events during a live deployment.POST /api/deployments/{id}/events
X-API-Key + X-Agent-ID headers).
The event type. See Event Types for the full list.
curl -X POST https://console.rotastellar.com/api/deployments/dep-456/events \
-H "Content-Type: application/json" \
-H "X-API-Key: rs_live_..." \
-H "X-Agent-ID: sat-25544" \
-d '{
"type": "step.completed",
"timestamp": "2026-03-07T14:23:45Z",
"job_id": "preset-001",
"step_id": "feature_extraction",
"payload": {
"duration_s": 180,
"location": "onboard",
"data_output_mb": 10.5
}
}'
{
"id": "evt-789"
}
{
"error": "type and timestamp are required"
}
Status Side Effects
Terminal events automatically update the deployment status:| Event Type | Deployment Status Change |
|---|---|
job.accepted | dispatched → running |
job.completed | → completed |
job.failed | → failed |

