Skip to main content
PUT
Edit a suggestion before approving it

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

kbId
string
required

Knowledge base to operate on. Get the ids from listMyKnowledgeBases.

entryId
string
required

Suggestion to edit, as returned by listImprovements.

Body

application/json

New text for a suggestion, before approving it.

title
string
required

The question this content answers.

response
string
required

The answer to publish once approved. Fill in any [COMPLETAR] blank here.

type
enum<string>
required

Support level this content answers at. INTERACTIVE is rejected.

Available options:
N1,
N2,
INTERACTIVE
label
string

Tag to apply. Omit to leave the content untagged.

topic
string

Topic to group this content under.

Response

The suggestion as stored.

An answer Claudia suggests for a question your content does not cover yet.

disabled
boolean
required

Always true while pending — a suggestion only starts answering once approved.

Example:

true

hasPlaceholder
boolean
required

True when the suggested answer still carries a blank the pipeline could not fill (e.g. [COMPLETAR: prazo]). Approving it is refused until you edit it.

Example:

false

createdAt
string
required

When it was suggested (ISO-8601).

Example:

"2026-08-10T14:32:05"

updatedAt
string
required

When it last changed (ISO-8601).

Example:

"2026-08-10T18:20:41"

id
string

Use this id to edit, approve or reject the suggestion.

Example:

"6683f1c2a4b19e0012ab34cd"

title
string

The question customers asked that nothing answered.

Example:

"Vocês entregam no interior?"

response
string

The answer being suggested. Edit it before approving if it needs work.

label
string

Tag suggested for this content.

Example:

"logistica"

topic
string

Topic this content would be grouped under.

Example:

"Entregas"

type
enum<string>

Support level the suggestion would answer at.

Available options:
N1,
N2,
INTERACTIVE
Example:

"N1"

gapStatus
enum<string>

How the gap compares to what you already have: NEW, SIMILAR to existing content, or an answer that EXISTS but did not surface.

Available options:
NEW,
SIMILAR,
EXISTS
rationale
string

Why this gap was proposed.

ticketCount
integer<int32>

How many conversations in the analysed window hit this gap.

Example:

14

sampleQuestions
object[]

Real customer questions behind the gap, already stripped of personal data.