Update a KB entry

PATCH

/api/kb-entries/{entryId}

• Production

Updates the content of an existing knowledge base entry. You can modify the question, answer, and/or topics. Only the fields you include in the request body are updated — omitted fields are left unchanged. When your account reviews knowledge base changes before they apply, the change is saved as a version that waits for approval in the dashboard, the entry stays as it is, and the answer is 202.

Authorizations

• bearerAuth

Parameters

Path Parameters

entryId

required

string format: uuid

The unique identifier of the KB entry to update.

Request Body

object

question

Updated question text.

string

>= 1 characters

Example

What are your delivery times within Europe?

answer

Updated answer text.

string

>= 1 characters

Example

Delivery within the EU takes 3-7 business days depending on the destination country.

topics

Updated topic tags. Replaces the existing tags entirely.

Array<string>

Example

[
  "shipping",
  "delivery",
  "europe"
]

Responses

200

The KB entry was updated and the changes are effective immediately.

A knowledge base (KB) entry is a question-answer pair that the AI uses to respond to customer inquiries. Entries can be created manually, imported via the API, or proposed automatically by the learning loop after resolved conversations. Proposed entries require human approval before the AI can use them.

object

id

required

Unique identifier for the KB entry.

string format: uuid

Example

kb1a2b3c-5678-9abc-def0-1234567890ab

tenantId

required

The tenant this entry belongs to.

string format: uuid

Example

a0b1c2d3-4567-89ab-cdef-0123456789ab

workspaceId

required

The workspace this entry is scoped to. The AI only uses entries from the workspace that matches the conversation.

string format: uuid

Example

w1a2b3c4-5678-9abc-def0-1234567890ab

question

required

The question or topic this entry addresses. This is what the AI matches against when a customer asks something.

string

Example

What are your delivery times to Germany?

answer

required

The answer the AI should use when this entry is matched. Can include specific details, links, and instructions.

string

Example

Standard delivery to Germany takes 3-5 business days. Express delivery (next business day) is available for an additional fee of EUR 12.50.

topics

required

Tags that categorize this entry. Used for filtering and to help the AI determine relevance.

Array<string>

Example

[
  "shipping",
  "delivery",
  "germany"
]

sourceType

required

How the entry came to be. manual is an entry written by a person, approved when it is created. extracted is a proposal the learning loop drafted from a resolved conversation. The API stores the value sent, and an entry created with a value other than manual starts as pending_review.

string

Example

manual

confidence

Confidence score between 0 and 1, set by the learning loop when proposing entries. Higher values indicate the AI is more confident the entry is accurate. Null for manually created entries.

number | null

Example

0.92

status

required

Where the entry stands. approved: in use, the assistant draws on it. pending_review: created for review, through the API with a sourceType other than manual; it is not used until it is approved. proposed: drafted by oHallo, for example by the learning loop from a resolved conversation; it is not used until it is approved, and a proposal that changes an existing entry is applied to that entry when it is approved. rejected: declined in review. archived: no longer in use, kept for the record.

string

Allowed values: pending_review approved rejected archived proposed

Example

approved

usageCount

required

Number of times this entry has been referenced by the AI when responding to conversations.

integer

Example

47

lastUsedAt

Timestamp of the last time the AI referenced this entry. Null if never used.

string | null format: date-time

Example

2026-03-25T14:20:00.000Z

createdAt

required

Timestamp when the entry was created.

string format: date-time

Example

2026-02-01T12:00:00.000Z

updatedAt

required

Timestamp when the entry was last updated.

string format: date-time

Example

2026-03-15T10:30:00.000Z

202

Your account reviews knowledge base changes before they apply: the change waits for approval as the version versionId, and the entry is unchanged until it is approved.

A change saved as a version that waits for approval in the dashboard. An account that reviews changes before they apply receives this for an update, and the record stays as it was until the version is approved.

object

pending

required

Always true.

boolean

Example

true

versionId

required

The version that waits for approval.

string format: uuid

Example

55443322-1100-4988-8776-655443322110

404

No KB entry exists with the given ID in the authenticated tenant.

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"
]

409

The new question is one another entry of the workspace has. Each question is held by one entry of the workspace, compared without case or surrounding spaces; a rejected entry holds none. code is duplicate_question and entryId names the entry that holds it. When your account reviews knowledge base changes, the update answers 202 and its question is checked when it is approved.

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"
]