Revise a prior HTML answer or report in the chat from anchored user annotations

post

https://api.corestack.io/v1/agent/query/revision

Revise a prior HTML answer or report in the chat from anchored user annotations; returns the new conversation id.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

chat_id

string

required

Chat the revision turn is appended to

agent_id

string

Agent that produced the source turn

tenant_id

string

Tenant of the chat

query

string

required

length ≤ 4000

Natural-language summary composed by the UI, shown in the chat bubble and used by the query guard and summarizer

revision_of

object

required

annotations

array of objects

required

length between 1 and 20

Anchored edit instructions

annotations*

kind

string

enum

required

What the annotation is anchored to

Allowed:

element_id

string

required

length ≤ 96

Id of the annotated element, as assigned by the backend's deterministic id pass

tag

string

length ≤ 32

Lower-case tag name of the annotated element

text

string

length ≤ 500

Visible text of the element or the selected text, plain text, truncated by the client

heading

string

length ≤ 300

Nearest preceding heading, so the agent can re-anchor when ids shift

instruction

string

required

length between 1 and 2000

What the user wants changed at this anchor

range

object

row_label

string

length ≤ 300

First-cell text of the annotated row; present only when kind is table-cell

column_label

string

length ≤ 300

Header text of the annotated column; present only when kind is table-cell

end_annotation_session

boolean

True when sent with Send and end; informational only

Responses

Language

Credentials

Header

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200Success

400Bad Request

401Unauthorized

404Not Found

500Internal Server Error