Apps
Remove a member's grant on an app
DELETE /v1/apps/{appId}/grants/{principalId} · SDK removeAppGrant · CLI deployments app-grant remove
DELETE
Requires apps:write; admits human callers. A suspended organization can still call it.
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 <= 512AppGrantResponse
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 DELETE "https://example.com/v1/apps/string/grants/string" \ -H "x-deployments-environment: string" \ -H "idempotency-key: string"{ "appId": "string", "createdAt": "2019-08-24T14:15:22Z", "grantedBy": "string", "principalId": "string", "role": "viewer", "updatedAt": "2019-08-24T14:15:22Z"}