Skip to the page

Approve the plan at its stated price (owner)

POST/v1/organisations/{id}/environments/{envId}/approve

Operation environments.approve · since 2026-11-05 · stable

Needs a session withwritescopeAnswers200 OK

{ "ok": true }. The environment starts at the cloud; billing starts with it.

Only an owner approves, and only the price stated: the prices you send must be the plan's.

Path parameters

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

Body (JSON)

planIdstring (uuid)required
The plan you approve, as environments.get answers it. A plan that changed since is refused (plan_changed).
hourlynumberrequired
The hourly price you approve, as stated on the plan.
monthlynumberrequired
The monthly price you approve, as stated on the plan.
teamMonthlynumberoptional
The monthly price of the AI team, when the environment has one.

Errors

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

  • not_approver
  • not_awaiting_approval
  • already_approved
  • plan_changed
  • busy
  • limit_spend
  • limit_account_budget
  • suspended
POST/v1/organisations/{id}/environments/{envId}/approve
curl -X POST "https://api.rykloud.com/v1/organisations/$ORG_ID/environments/$ENV_ID/approve" \
  -H "Authorization: Bearer $RYKLOUD_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "planId": "00000000-0000-4000-8000-000000000002",
  "hourly": 0.06,
  "monthly": 43.8
}'
With the rykloud CLI
rykloud envs approve [ENV] [flags]

Command reference: rykloud envs approve