Skip to main content
POST
Test connection permissions

Authorizations

Authorization
string
header
required

Bearer token for the authenticated caller.

Headers

akua-context
string

Optional workspace/scope context for the request. Carries a single workspace wire id (ws_…) today. Only needed for broad tokens - a workspace-owned token implies its workspace.

Required string length: 1 - 53
Example:

"ws_j572abc123def4"

Path Parameters

vault
string
required

A vault id chosen by its creator, unique in the Workspace. default is the Workspace vault.

Pattern: ^[a-z]([a-z0-9-]{0,61}[a-z0-9])?$
Example:

"default"

connection
string
required

A connection id

Pattern: ^conn_[^\s/]{1,64}$
Example:

"conn_j572abc123def456"

Body

application/json
permissions
tuple
required

Response

TestIamPermissionsResponse

permissions
string[]
required
Maximum array length: 100

A permission service.resource.verb

Pattern: ^[a-z][a-z0-9-]{0,62}\.[a-z][a-z0-9-]{0,62}\.[a-z][a-z0-9-]{0,62}$