Skip to the page

Ask for production shell access, or break the glass (owners)

POST/v1/organisations/{id}/environments/{envId}/terminal/approvals

Operation terminal.requestApproval · since 2026-11-05 · stable

Needs a session withwritescopeAnswers201 Created

Path parameters

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

Body (JSON)

Fields not listed here are refused.

reasonstring, 3 to 500required
Why you need a shell in production.
windowMinutesinteger, 15 to 480optional
How long the access lasts.
breakGlassbooleanoptional
Owners: open it at once, recorded as an emergency.

Errors

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

POST/v1/organisations/{id}/environments/{envId}/terminal/approvals
curl -X POST "https://api.rykloud.com/v1/organisations/$ORG_ID/environments/$ENV_ID/terminal/approvals" \
  -H "Authorization: Bearer $RYKLOUD_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "reason": "<reason>"
}'