Integrations

List integration grants for an agent

Readable by the agent's owner or by an admin of the owner's company — the connections themselves belong to the company. 404 for anyone else.

get/agents/{agentId}/integration-grants

Request

  • Base URL: https://api.atako.ai
  • URL: https://api.atako.ai/agents/{agentId}/integration-grants
  • Auth: HTTP bearer

Path parameters

agentIdstring required

Agent id

Response

idstring uuid required
agentIdstring uuid
connectionIdstring uuid required
allowedToolsstring[]
scope'read' | 'write' | 'read_write' required
constraintsobject nullable
grantedBystring uuid
expiresAtstring date-time nullable
createdAtstring date-time required
maskedboolean

List endpoint only: true for another user's PERSONAL connection (an admin viewing a colleague's agent) — no connection name, only ownerName. Revocable, not editable.

ownerNamestring nullable

Masked rows only: the personal connection owner's first name.

isDefaultboolean

Present (true) ONLY on a SYNTHETIC row the list endpoint fabricates for a companyWide+defaultGranted connector (e.g. 'projects') when this agent has no explicit integration_grants row yet — it already has full access by default; this row lets the UI show that instead of "no access". id/connectionId both equal the connection's own id on a synthetic row (no real grant row exists) — DELETE on that id persists an opt-out (a real row with allowedTools:[]) instead of a no-op. Absent (never false) on a real row.

Changes

No recorded changes to this operation across all 2 revisions of this API.