Skip to main content
PATCH
Replace an integration connection's credential, or rename it, in place

Authorizations

Authorization
string
header
required

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

Path Parameters

id
string
required

Connection id

Body

application/json
displayName
string

Rename only (no secret).

Maximum string length: 80
secret
string

The new credential. Write-only — never read back.

config
object | null

Response

Never includes credential material.

id
string<uuid>
required
providerKey
string
required
displayName
string
required
authType
enum<string>
required
Available options:
api_key,
oauth2,
mcp,
internal
status
enum<string>
required
Available options:
active,
error,
revoked
createdAt
string<date-time>
required
companyId
string<uuid> | null
visibility
enum<string>

'company' = shared with the whole company, managed by its admins; 'personal' = visible to, managed and grantable (to their own agents) by its creator only. Another member's personal connections are never returned.

Available options:
company,
personal
isMine
boolean

Created by the caller.

actions
object[]

List endpoint, custom MCP connections only (providerKey 'mcp', no catalog entry): the active tools, catalog-shaped.

mcp
object

List endpoint, custom MCP connections only.

externalLabel
string | null
config
object | null
scopes
string[]
lastUsedAt
string<date-time> | null
createdBy
string<uuid>