---
title: "Link an item to a survey theme"
method: POST
path: "/engagement/surveys/{surveyId}/insights/links"
tags: ["Engagement Survey"]
---

# Link an item to a survey theme

`POST /engagement/surveys/{surveyId}/insights/links`

## Request

- Base URL: `https://api.gleap.io/v3`
- URL: `https://api.gleap.io/v3/engagement/surveys/{surveyId}/insights/links`
- Auth: HTTP bearer

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`.

## Path parameters

- `surveyId` string, required

## Headers

- `project` string, required

## Request body

- unknown

## Response `200`

Ok

- unknown

## Changes

- **2026-10-08** `fd83cd1963c4`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/gleap/apis/gleap-server/changes/engagement/surveys/:surveyId/insights/links/post.md)

---

[API](https://skmtc.dev/gleap/apis/gleap-server.md) - [All operations](https://skmtc.dev/gleap/apis/gleap-server/llms.txt) - [OpenAPI document](https://skmtc.dev/gleap/apis/gleap-server/revisions/3b025e883cef?raw)