List knowledge base topics

GET

/api/workspaces/{workspaceId}/kb-entries/topics

• Production

Returns the topics in use in a workspace’s knowledge base: the topic tags of its approved entries, each once, sorted by name. Use them to tag a new entry, so entries on the same subject share a tag.

Authorizations

• bearerAuth

Parameters

Path Parameters

workspaceId

required

string format: uuid

The workspace to list topics for.

Responses

200

The topics of the workspace’s approved KB entries. An empty array when the workspace has no approved entry with a topic.

object

topics

required

The topic tags of the workspace’s approved entries, each once, sorted by name.

Array<string>

Example

[
  "delivery",
  "returns",
  "shipping"
]

404

No workspace exists with the given workspaceId, or it is outside the API key’s brand or workspace restriction.

Standard error response returned by all endpoints on failure.

object

error

required

A human-readable error message describing what went wrong.

string

Example

Conversation not found

code

A machine-readable reason on some refusals, for example ‘key_lock’ when an API key’s brand or workspace restriction does not cover the action.

string

Example

key_lock

missing_scopes

On a 403 for an API key without a scope the endpoint requires: the scopes the key lacks.

Array<string>

Example

[
  "mcp:write"
]

entryId

On a 409 with code duplicate_question or duplicate_rule_text: the knowledge base entry or policy that already holds the question or rule text.

string format: uuid

Example

11223344-5566-4788-99aa-bbccddeeff00

connectionId

On a 422 about one MCP connection a request names, from an assignment or an agent create or update (a connection that does not exist, one listed twice, or one that does not declare a tool named): the connection, as the request named it.

string

undeclaredTools

On the same 422: the tool names the connection does not declare.

Array<string>

Example

[
  "get_orders"
]

declaredTools

On the same 422: the tools the connection declares.

Array<string>

Example

[
  "get_order",
  "search_orders"
]