Skip to content
Last updated

Create, retrieve, update, and delete connector destination definitions for an organization.

List destination definitions

GEThttps://api.aitronos.com/v1/organizations/{organization_id}/knowledge/connectors/destination-definitions

Returns all available destination definitions in the organization's workspace.

Path Parameters

organization_id string required

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


Get destination definition

GEThttps://api.aitronos.com/v1/organizations/{organization_id}/knowledge/connectors/destination-definitions/{definition_id}

Retrieve a single destination definition by ID.

Path Parameters

definition_id string required

The destination definition ID.


Create destination definition

POSThttps://api.aitronos.com/v1/organizations/{organization_id}/knowledge/connectors/destination-definitions

Create a custom destination definition.

Request Body

name string required

Definition name.

docker_repository string optional

Docker repository for the connector image.

docker_image_tag string optional

Docker image tag / version.

documentation_url string optional

URL to the connector documentation.


Update destination definition

PUThttps://api.aitronos.com/v1/organizations/{organization_id}/knowledge/connectors/destination-definitions/{definition_id}

Update an existing destination definition.

Request Body

name string optional

Updated definition name.

docker_image_tag string optional

Updated Docker image tag.

documentation_url string optional

Updated documentation URL.


Delete destination definition

DELETEhttps://api.aitronos.com/v1/organizations/{organization_id}/knowledge/connectors/destination-definitions/{definition_id}

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


Returns

A destination definition object containing destination_definition_id, name, docker_repository, docker_image_tag, documentation_url, and icon.

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