Skip to the page

Give a member a role in an environment

PUT/v1/organisations/{id}/environments/{envId}/access/{subject}

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

Needs a session withwritescopeAnswers200 OK

Path parameters

idstring (uuid)required
The organisation id.
envIdstring (uuid)required
The environment id.
subjectstringrequired
The person, by their Rykon account subject.

Body (JSON)

rolestringrequired
"owner", "maintainer", "developer" or "viewer"

Errors

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

PUT/v1/organisations/{id}/environments/{envId}/access/{subject}
curl -X PUT "https://api.rykloud.com/v1/organisations/$ORG_ID/environments/$ENV_ID/access/$SUBJECT" \
  -H "Authorization: Bearer $RYKLOUD_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "role": "<role>"
}'