Skip to main content
POST
cURL

Authorizations

x-api-key
string
header
required

API Key authentication. Format: 'x-api-key: api_key'

Body

A connection to an external system that AI agents can call tools against.

connector
string
required

Connector of this connection (Expandable)

config
any
callback_webhook
object | null

Where Nekt announces that someone finished configuring this connection through a setup link.

active
boolean

The user on/off toggle. Activating clears draft and error.

slug
string

Stable identifier and tool namespace; globally unique. Defaults to the connector slug (uniquified) when left blank.

Maximum string length: 256
Pattern: ^[-a-zA-Z0-9_]+$
description
string | null
available_tools
string[]

Response

201 - application/json

A connection to an external system that AI agents can call tools against.

id
string<uuid>
required
read-only
connector
string
required

Connector of this connection (Expandable)

connector_version
string<uuid>
required
read-only
connector_config
object
required
read-only
has_callback_webhook
boolean
required
read-only
credentials_version
integer
required
read-only

Bumped whenever connector_config changes (in the viewset/serializer, not a signal); the MCP uses it to invalidate its credential cache

draft
boolean
required
read-only

Not yet activated for the first time; the setup-link flow is only valid while draft (or error).

error
boolean
required
read-only

Set by the credential broker on a refused OAuth refresh; the connection needs a reconnect and is not served while set.

archived
boolean
required
read-only

Set via the archive/unarchive endpoints (mirrors Pipeline.archived); archived connections are never served to the MCP server.

tags
any[]
required
read-only
permission_level
string | null
required
read-only
created_by
object
required
read-only
created_at
string<date-time>
required
read-only
updated_at
string<date-time>
required
read-only
active
boolean

The user on/off toggle. Activating clears draft and error.

slug
string

Stable identifier and tool namespace; globally unique. Defaults to the connector slug (uniquified) when left blank.

Maximum string length: 256
Pattern: ^[-a-zA-Z0-9_]+$
description
string | null
available_tools
string[]