Suggest the next questions a visitor might ask, from their own conversation.
POST/v1/projects/{projectId}/chat/follow-upsTry it
Suggest up to three short questions the visitor might ask next. Suggestions come from the conversation's own last exchange — its latest question and the last few messages — and from the documentation retrieved for that question, so they only point at things your docs can answer.
The endpoint is public (no API key required) and scoped like Conversation History: it only reads a session that belongs to this project and to the visitorId you send. For any other session it returns an empty list rather than an error.
Path Parameters
NameDescription
projectId:stringpathRequired
The project ID.
Request Body
NameDescription
sessionId:stringbodyRequired
UUID of the conversation — the X-Session-Id header from the chat endpoint.
visitorId:stringbody
The anonymous visitor identifier that started the session (1–100 chars). Omit it only for a session that was started without one.
Response
questions is empty when the session isn't this visitor's, has no question yet, or suggestions couldn't be generated. Treat an empty list as "show nothing".
Note
On your doc site this endpoint is also served same-origin at POST /_chat/follow-ups. The project comes from the site's hostname.
Error Responses
Status
Code
When
400
validation_error
sessionId is missing or not a UUID, or visitorId is empty or over 100 characters
403
FORBIDDEN
The site is private (password, invite-only or SSO) and the request didn't come through the doc site ("Ask from the docs site")