> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rotastellar.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Session

> Creates a new simulation session with the given satellite constellation

<Note>
  **Base URL:** `https://sim.rotastellar.com`
  — No API key required.
</Note>

<RequestExample>
  ```bash theme={null}
  curl -X POST https://sim.rotastellar.com/v1/sessions \
    -H "Content-Type: application/json" \
    -d '{
      "satellites": [
        {
          "id": "sat-001",
          "name": "RS-LEO-1",
          "elements": { "altitude_km": 550, "inclination_deg": 53 }
        },
        {
          "id": "sat-002",
          "name": "RS-LEO-2",
          "elements": { "altitude_km": 550, "inclination_deg": 53 }
        },
        {
          "id": "sat-003",
          "name": "RS-LEO-3",
          "elements": { "altitude_km": 600, "inclination_deg": 97.4 }
        }
      ]
    }'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "session_id": "ses_abc123",
    "satellites": 3,
    "created_at": "2026-03-10T12:00:00Z"
  }
  ```
</ResponseExample>