Set application plugin permission

allow_reads permits reads; writes still require approval. ask requires approval for each action. disabled blocks future calls. Changes invalidate outstanding action authorizations.

PUT/v1/applications/{id}/plugins/{pluginId}

Authorization

Authorizationstringrequired

Bearer tak_… — an application API key. Keep it on your backend; all resources are scoped to that application.

Create an application key →

Path parameters

idstringrequired

Min length: 1

pluginIdstringrequired

Allowed: "gmail""web""github""drive""calendar""slack""figma"

Body application/json

permissionstringrequired

Allowed: "allow_reads""ask""disabled"

Response

200Set application plugin permission

X-Request-Idstring

Server-generated request identifier for logs and support.

application/json

application_idstringrequired

Min length: 1

plugin_idstringrequired

Allowed: "gmail""web""github""drive""calendar""slack""figma"

permissionstringrequired

Allowed: "allow_reads""ask""disabled"

revisionintegerrequired

Minimum: -9007199254740991 · Maximum: 9007199254740991

4XX400 invalid input; 401 missing/revoked credentials; 403 disallowed operation/application; 404 missing or inaccessible resource; 409 conflicting submission/version/state; 413 body too large; 415 unsupported content type. Inspect error.code, not message text.

X-Request-Idstring

Server-generated request identifier for logs and support.

application/json

errorobjectrequired

Object fields

codestringrequired

messagestringrequired

request_idstringrequired

Additional keys: any

5XX500 unexpected failure or 503 unavailable dependency. A failed response does not prove that a submission was not committed. Retry job/flow admission with the same key and body.

X-Request-Idstring

Server-generated request identifier for logs and support.

application/json

errorobjectrequired

Object fields

codestringrequired

messagestringrequired

request_idstringrequired

Additional keys: any