Skip to content
/
Manage workspaces
Last updated

Manage workspaces

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

List workspaces

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

Returns all connector workspaces.

Path Parameters

organization_id string required

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

Get workspace

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

Retrieve a single workspace by ID.

Path Parameters

organization_id string required

The unique identifier of the organization.

workspace_id string required

The connector workspace ID.

Create workspace

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

Create a new connector workspace.

Request Body

name string required

Human-readable workspace name.

Update workspace

PATCHhttps://api.aitronos.com/v1/organizations/{organization_id}/knowledge/connectors/workspaces/{workspace_id}

Update workspace properties.

Request Body

name string optional

Updated workspace name.

Delete workspace

DELETEhttps://api.aitronos.com/v1/organizations/{organization_id}/knowledge/connectors/workspaces/{workspace_id}

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

Set OAuth credentials

PUThttps://api.aitronos.com/v1/organizations/{organization_id}/knowledge/connectors/workspaces/{workspace_id}/oauth-credentials

Set OAuth credentials on a workspace for use by sources that require OAuth.

Request Body

actor_type string required

The actor type (e.g., workspace).

name string required

Credential name.

configuration object required

OAuth configuration blob containing client_id, client_secret, etc.

Returns

A workspace object containing workspace_id, name, and data_residency.

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