Skip to main content
POST
Approve suggestions

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.

Body

application/json

The suggestions to approve.

ids
string[]
required

Up to 200 ids, as returned by the listing.

Up to 200 ids, as returned by the listing.

Response

The per-id outcome of the batch.

What happened to each id in the batch.

skipped
string[]
required

Ids already decided before this call, or that lost a race against a concurrent decision. Nothing changed for them.

Ids already decided before this call, or that lost a race against a concurrent decision. Nothing changed for them.

notFound
string[]
required

Ids that do not exist, belong to another knowledge base, or are not reviewable here.

Ids that do not exist, belong to another knowledge base, or are not reviewable here.

approved
string[]

Ids that were approved. Absent on a reject call.

Ids that were approved. Absent on a reject call.

rejected
string[]

Ids that were rejected. Absent on an approve call.

Ids that were rejected. Absent on an approve call.

blocked
string[]

Ids refused because they still need editing (an unfilled blank, or a change this API cannot apply on its own).

Ids refused because they still need editing (an unfilled blank, or a change this API cannot apply on its own).

failed
string[]

Ids whose decision was recorded but could not be applied, and were rolled back to pending. Safe to retry.

Ids whose decision was recorded but could not be applied, and were rolled back to pending. Safe to retry.