Skip to main content
POST
/
api
/
capacity
/
reservations
Create Reservation
curl --request POST \
  --url https://app.opencomputer.dev/api/capacity/reservations \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "intervals": [
    {}
  ],
  "intervals[].startsAt": "<string>",
  "intervals[].endsAt": "<string>",
  "intervals[].capacityGb": 123
}
'
{
  "reservationId": "9f67b8f7-7b91-4d2d-b1cb-19d0d0a14562",
  "createdAt": "2026-04-28T18:00:05Z",
  "intervals": [
    {
      "startsAt": "2026-04-29T02:00:00Z",
      "endsAt":   "2026-04-29T02:15:00Z",
      "capacityGb": 16
    },
    {
      "startsAt": "2026-04-29T02:15:00Z",
      "endsAt":   "2026-04-29T02:30:00Z",
      "capacityGb": 16
    }
  ]
}
Coming soon. Reserved capacity is not yet available. See the Reserved Capacity overview.
Commit capacity across one or more 15-minute UTC intervals in a single atomic write. The result is one reservation event with a server-generated reservationId covering all intervals in the request. See Reserving capacity for the full write contract. Send an Idempotency-Key header so retries return the original result. Same key with a different body returns idempotency_key_conflict. Reservations are non-refundable — there is no cancellation, modification, or transfer.
​
intervals
array
required
One entry per 15-minute interval to reserve.
​
intervals[].startsAt
string
required
Interval start. RFC 3339, UTC, aligned to 15 minutes (:00, :15, :30, :45).
​
intervals[].endsAt
string
required
Interval end. Must equal startsAt + 15 minutes. Multi-interval spans are rejected.
​
intervals[].capacityGb
integer
required
Positive multiple of 4 (the grain is 1 GB-hour = 4 GB × 15 min). Other values are rejected.
{
  "reservationId": "9f67b8f7-7b91-4d2d-b1cb-19d0d0a14562",
  "createdAt": "2026-04-28T18:00:05Z",
  "intervals": [
    {
      "startsAt": "2026-04-29T02:00:00Z",
      "endsAt":   "2026-04-29T02:15:00Z",
      "capacityGb": 16
    },
    {
      "startsAt": "2026-04-29T02:15:00Z",
      "endsAt":   "2026-04-29T02:30:00Z",
      "capacityGb": 16
    }
  ]
}