curl -X POST https://console.rotastellar.com/api/deployments \
-H "Content-Type: application/json" \
-H "Cookie: session=..." \
-d '{
"plan_id": "abc-123",
"speed_multiplier": 100
}'
curl -X POST https://console.rotastellar.com/api/deployments \
-H "Content-Type: application/json" \
-H "X-API-Key: rs_live_..." \
-d '{
"plan_id": "abc-123"
}'
{
"id": "dep-456",
"status": "pending"
}
{
"error": "plan_id is required"
}
{
"error": "Plan not found"
}
Deployments
Create Deployment
Create a new deployment from a plan
POST
/
api
/
deployments
curl -X POST https://console.rotastellar.com/api/deployments \
-H "Content-Type: application/json" \
-H "Cookie: session=..." \
-d '{
"plan_id": "abc-123",
"speed_multiplier": 100
}'
curl -X POST https://console.rotastellar.com/api/deployments \
-H "Content-Type: application/json" \
-H "X-API-Key: rs_live_..." \
-d '{
"plan_id": "abc-123"
}'
{
"id": "dep-456",
"status": "pending"
}
{
"error": "plan_id is required"
}
{
"error": "Plan not found"
}
Base URL:
https://console.rotastellar.com
ā Requires session cookie or API key authentication.Request
string
required
The ID of the plan to deploy. The plan must belong to the authenticated user.
number
Simulation speed for simulated deployments. Default:
100. A value of 100 means a 90-minute orbit plays in ~1 minute.curl -X POST https://console.rotastellar.com/api/deployments \
-H "Content-Type: application/json" \
-H "Cookie: session=..." \
-d '{
"plan_id": "abc-123",
"speed_multiplier": 100
}'
curl -X POST https://console.rotastellar.com/api/deployments \
-H "Content-Type: application/json" \
-H "X-API-Key: rs_live_..." \
-d '{
"plan_id": "abc-123"
}'
{
"id": "dep-456",
"status": "pending"
}
{
"error": "plan_id is required"
}
{
"error": "Plan not found"
}
Status Lifecycle
After creation, the deployment status transitions:| Status | Meaning |
|---|---|
pending | Created, waiting to start |
dispatched | Assigned to an agent (live mode) |
running | Agent is executing |
completed | All steps finished successfully |
failed | Execution failed |
cancelled | Cancelled by user |