Skip to the page

Set an environment's seats and mailboxes, at the stated monthly price

PUT/v1/organisations/{id}/environments/{envId}/team

Operation billing.setTeam · since 2026-11-05 · stable

Needs a session withwritescopeAnswers200 OK

Path parameters

idstring (uuid)required
The organisation id.
envIdstring (uuid)required
The environment id.

Body (JSON)

seatsinteger, 0 to 1000required
AI team seats.
mailboxesinteger, 0 to 10000required
Agent mailboxes.
statedMonthlynumberoptional
The monthly price you accept, as quoted.

Errors

Every error is { "error", "message", "detail"? } (Errors and references). Besides the codes any route can answer, this one refuses with:

  • too_many_mailboxes
  • seat_price_not_set
PUT/v1/organisations/{id}/environments/{envId}/team
curl -X PUT "https://api.rykloud.com/v1/organisations/$ORG_ID/environments/$ENV_ID/team" \
  -H "Authorization: Bearer $RYKLOUD_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "seats": 0,
  "mailboxes": 0
}'