Skip to content

List connector permissions

GET
/api/v1/connectors/permissions

Returns humanized permission summaries for the tenant’s connected connector instances. Returns an empty list (200) for a tenant with no connectors — never 404.

Authorizations

Responses

200

Successful Response

Response for GET /connectors/permissions.

Attributes: connectors: The tenant’s connected instances with permission summaries. Empty list if the tenant has no connected connectors.

object
connectors
required
Array<object>

A connected connector instance with its humanized permission summary.

Attributes: id: Connector instance UUID. name: Display name (from the connector registry). status: ‘healthy’ if the instance is active, ‘error’ otherwise. permissions: The humanized permission summary.

object
id
required
string
name
required
string
permissions
required

Humanized permission summary for one connected connector instance.

Field shapes mirror the frontend’s ConnectorPermission interface in frontend/src/app/(dashboard)/settings/connectors/connector-permissions.tsx exactly — this is a display-oriented projection of ConnectorPermission, not the raw ORM record.

Attributes: data_read_scope: Human-readable description of what data may be read. action_permissions: Names of actions currently enabled (e.g. [‘read’, ‘create’]). spending_limit: Per-transaction spending cap, or None if unset. rate_limit: Human-readable rate limit (e.g. ‘10/minute’). approval_gate: Human-readable description of the approval requirement. audit_level: One of ‘full’, ‘standard’, ‘minimal’.

object
action_permissions
required
Array<string>
approval_gate
required
string
audit_level
required
string
Allowed values: full standard minimal
data_read_scope
required
string
rate_limit
required
string
spending_limit
required
Any of:
number
status
required
string
Allowed values: healthy error