Apps
Grant an organization member viewer or editor on an app
PUT /v1/apps/{appId}/grants/{principalId} · SDK putAppGrant · CLI deployments app-grant set
PUT
Requires apps:write; admits human callers.
platformBearerheader
AuthorizationBearer <token>Platform bearer credential accepted as an opaque API key or JWT.
appId*stringMatch
^[0-7][0-9A-HJKMNP-TV-Z]{25}$principalId*stringMatch
^[0-7][0-9A-HJKMNP-TV-Z]{25}$x-deployments-environment*stringMatch
^[0-7][0-9A-HJKMNP-TV-Z]{25}$idempotency-key*stringLength
1 <= length <= 512application/json- body
role*stringValue in
"viewer""editor"AppGrantResponse
application/json- response
appId*stringMatch
^[0-9A-HJKMNP-TV-Za-hjkmnp-tv-z]{26}$createdAt*stringMatch
^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.\d{3}Z$Format
date-timegrantedBy*stringMatch
^[0-9A-HJKMNP-TV-Za-hjkmnp-tv-z]{26}$principalId*stringMatch
^[0-9A-HJKMNP-TV-Za-hjkmnp-tv-z]{26}$role*stringValue in
"viewer""editor"updatedAt*stringMatch
^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.\d{3}Z$Format
date-timecurl -X PUT "https://example.com/v1/apps/string/grants/string" \ -H "x-deployments-environment: string" \ -H "idempotency-key: string" \ -H "Content-Type: application/json" \ -d '{ "role": "viewer" }'{ "appId": "string", "createdAt": "2019-08-24T14:15:22Z", "grantedBy": "string", "principalId": "string", "role": "viewer", "updatedAt": "2019-08-24T14:15:22Z"}