Manage tags
Copy for LLM
Copy page as Markdown for LLMs
View as Markdown
Open this page as Markdown
Open in ChatGPT
Get insights from ChatGPT
Open in Claude
Get insights from Claude

Create, retrieve, update, and delete tags for labeling and organizing connections.

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

Returns all tags in the organization's workspace.

organization_id string required

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

Get tag

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

Retrieve a single tag by ID.

tag_id string required

The tag ID.

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

Create a new tag for labeling connections.

name string required

Tag display name.

workspace_id string required

The workspace to create the tag in.

color string optional

Hex color code (e.g. #FF5733).

PATCHhttps://api.aitronos.com/v1/organizations/{organization_id}/knowledge/connectors/tags/{tag_id}

Partially update a tag's properties.

name string optional

Updated tag name.

color string optional

Updated hex color code.

DELETEhttps://api.aitronos.com/v1/organizations/{organization_id}/knowledge/connectors/tags/{tag_id}

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

A tag object containing tag_id, name, color, and workspace_id.

cURL

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