Skip to main content
POST
Grant (or update) an agent's access to an integration connection

Authorizations

Authorization
string
header
required

An aik_… programmatic API key (app.atako.ai → Settings → API keys) or a Supabase session JWT.

Path Parameters

agentId
string
required

Agent id

Body

application/json
connectionId
string<uuid>
providerKey
string

"code" is the one value that substitutes for connectionId.

allowedTools
string[]

Filtered server-side to valid connector actions.

scope
enum<string>
default:read
Available options:
read,
write,
read_write
expiresAt
string<date-time> | null
constraints
object | null

Response

id
string<uuid>
required
agentId
string<uuid>
required
connectionId
string<uuid>
required
scope
enum<string>
required
Available options:
read,
write,
read_write
createdAt
string<date-time>
required
allowedTools
string[]
constraints
object | null
grantedBy
string<uuid>
expiresAt
string<date-time> | null
connection
object

Only present on the list endpoint (joined).