Engagement Survey

Link an item to a survey theme

Link a bug / feature request (ticketId) or a Kai Code session (cloudSessionId, or the clientLaunchId of a Kai Code draft that is not sent yet) to an AI theme (themeId) and/or a finding of the brief (finding: its title). The ticket or session must belong to the survey's project. Linking the same item twice returns the existing link. Returns { link }; GET /insights returns every link as links and per theme as themes[].links.

POST

https://api.gleap.io/v3/engagement/surveys/{surveyId}/insights/links

Authorizations

Authorizationstring · headerrequired

Bearer authentication header of the form Bearer <token>.

Path parameters

surveyIdstringrequired

Headers

projectstringrequired

Bodyapplication/jsonrequired

Response

application/json

Updated November 1, 2026

curl --request POST \
  --url 'https://api.gleap.io/v3/engagement/surveys/{surveyId}/insights/links' \
  --header 'Authorization: Bearer <token>' \
  --header 'project: <project>' \
  --header 'Content-Type: application/json' \
  --data '{}'

No example in the spec.