Skip to main content

revoke_access

Remove run access to a Flight you own from users, roles, or your whole organization. Organization Admins can also revoke run grants on Flights they don't own. The SQL equivalent is REVOKE RUN ON FLIGHT.

Description​

Revoking a grant that doesn't exist succeeds and changes nothing. Other grants on the Flight stay in place.

Input parameters​

ParameterTypeRequiredDescription
resource_typestringYes"flight".
idstring (UUID)YesThe Flight UUID.
granteesobject[]Yes1 to 100 grantees, each { "type": "user" | "role" | "organization", "name": string }. Omit name for the organization, or pass null; any other name for an organization grantee is an error. An unknown name fails the whole call.
permissionstringNo"run", the default.

Output schema​

On success:

{
"success": true,
"resource_type": "flight",
"id": string,
"permission": "run",
"grantees": [{ "type": string, "name": string }]
}

grantees echoes the grantees you passed. An organization grantee has no name.

On failure, only the error:

{
"success": false,
"error": string
}

Example usage​

{
"resource_type": "flight",
"id": "7b1e2c3d-0000-4000-8000-000000000001",
"grantees": [{ "type": "organization" }]
}