Skip to content
Last updated

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

List destinations

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

Returns all configured destinations in the organization's workspace.

Path Parameters

organization_id string required

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


Get destination

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

Retrieve a single destination by ID.

Path Parameters

destination_id string required

The destination ID.


Create destination

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

Create a new destination.

Request Body

name string required

Human-readable destination name.

destination_definition_id string required

The destination definition to use.

workspace_id string required

The workspace to create the destination in.

configuration object optional

Destination-specific configuration (connection details, credentials, etc.).


Update destination

PATCHhttps://api.aitronos.com/v1/organizations/{organization_id}/knowledge/connectors/destinations/{destination_id}

Partially update a destination's properties.

Request Body

name string optional

Updated destination name.

configuration object optional

Partial configuration updates.


Delete destination

DELETEhttps://api.aitronos.com/v1/organizations/{organization_id}/knowledge/connectors/destinations/{destination_id}

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


Returns

A destination object containing destination_id, name, destination_definition_id, workspace_id, configuration, and destination_type.

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