Skip to content
Last updated

Create, retrieve, update, and delete connector connections for an organization.

List connections

GEThttps://api.aitronos.com/v1/organizations/{organization_id}/knowledge/connectors/connections

Returns all connections in the organization's workspace.

Path Parameters

organization_id string required

The unique identifier of the organization (format: org_*).


Get connection

GEThttps://api.aitronos.com/v1/organizations/{organization_id}/knowledge/connectors/connections/{connection_id}

Retrieve a single connection by ID.

Path Parameters

connection_id string required

The connection ID.


Create connection

POSThttps://api.aitronos.com/v1/organizations/{organization_id}/knowledge/connectors/connections

Create a new connection between a source and destination.

Request Body

source_id string required

Source to connect from.

destination_id string optional

Destination to connect to. Auto-filled if omitted.

name string optional

Human-readable connection name.

schedule object optional

Sync schedule configuration.

configurations object optional

Stream configurations.

status string optional

Connection status: active or inactive.


Update connection

PATCHhttps://api.aitronos.com/v1/organizations/{organization_id}/knowledge/connectors/connections/{connection_id}

Partially update a connection's properties.

Request Body

name string optional

Updated connection name.

schedule object optional

Updated sync schedule.

configurations object optional

Updated stream configurations.

status string optional

Set to active or inactive.


Delete connection

DELETEhttps://api.aitronos.com/v1/organizations/{organization_id}/knowledge/connectors/connections/{connection_id}

Permanently delete a connection. Returns 204 No Content on success.


Returns

A connection object containing connection_id, name, source_id, destination_id, workspace_id, status, schedule, and configurations.

cURL
curl "https://api.aitronos.com/v1/organizations/org_xyz789/knowledge/connectors/connections" \
  -H "Authorization: Bearer $ACCESS_TOKEN"