/Docs
Search docs or ask a question⌘K
DocsAgent
Changelog
API Reference Suggest Follow-up Questions

Suggest Follow-up Questions

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

StatusCodeWhen
400validation_errorsessionId is missing or not a UUID, or visitorId is empty or over 100 characters
403FORBIDDENThe site is private (password, invite-only or SSO) and the request didn't come through the doc site ("Ask from the docs site")
•
Ask the AI Assistant — start or continue a conversation
•
Conversation History — the visitor's conversations
Was this page helpful? Yes No
Request
bashJavaScriptPythonGoRubyPHPJavaC#bash
curl -X POST https://api.syntext.dev/v1/projects/3f2a9c1e-8b4d-4e7a-9c21-5d6e7f8a9b0c/chat/follow-ups \
-H "Content-Type: application/json" \
-d '{ "sessionId": "123e4567-e89b-12d3-a456-426614174000", "visitorId": "vis_9f8e7d" }'
Responseapplication/json
json
{
"data": {
"questions": [
"How do I verify my domain?",
"Can I use a subdomain?",
"How long does SSL take?"
]
}
}
Product
Resources
Company
© 2026 SyntextBuilt with Syntext