Skip to main content

ReserveSeat creates a seat reservation with wallet hold.

POST 
/api/v1/billing/seats/reserve

This is the first step in the saga pattern for atomic seat purchase. The reservation holds the wallet balance for the seat cost and expires after 5 minutes. Used by auth service when creating unified agents.

Saga Pattern​

  1. ReserveSeat - holds wallet balance, returns reservation ID
  2. Create agent (in auth service)
  3. CommitReservation - creates seat, links to agent OR
  4. RollbackReservation - refunds wallet hold if agent creation fails

Authorization​

Internal service call only (requires service token).

Request​

Responses​

A successful response.