Skip to main content
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.com

​
List Events

Retrieve execution events for a deployment, ordered chronologically. 
GET /api/deployments/{id}/events
Authentication: Session cookie (Console UI) or API key.
​
id
string
required
The deployment ID.
​
offset
number
Pagination offset. Default: 0.
​
limit
number
Maximum number of events to return. Default: 100, max: 500.
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
Authentication: API key only (X-API-Key + X-Agent-ID headers).
​
type
string
required
The event type. See Event Types for the full list.
​
timestamp
string
required
ISO 8601 timestamp of when the event occurred.
​
job_id
string
Job identifier linking related events.
​
step_id
string
Step identifier, if the event relates to a specific compute or transfer step.
​
payload
object
Event-specific data. Contents vary by event type.
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"
}

​
Status Side Effects

Terminal events automatically update the deployment status:
Event TypeDeployment Status Change
job.accepteddispatched → running
job.completed→ completed
job.failed→ failed