---
title: "Link Session To Query"
method: POST
path: "/api/sdk/v1/attribution/link"
tags: ["SDK"]
---

# Link Session To Query

`POST /api/sdk/v1/attribution/link`

## Request

- Base URL: `https://geo.sig.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://geo.sig.ai/api/sdk/v1/attribution/link`
- Auth: none declared

Link a user session to an AI query execution for attribution tracking.

This endpoint establishes the connection between an AI-generated answer
and subsequent user activity, enabling closed-loop analytics from
AI query → user visit → conversion → revenue.

**Use Case:**
When a user clicks a link from an AI assistant (ChatGPT, Gemini, etc.),
extract the `query_id` parameter and call this endpoint to establish attribution.

**Example:**
```
User clicks: https://yourapp.com?query_id=abc-123&utm_source=chatgpt
SDK extracts query_id and calls: POST /attribution/link
```

**Request Body:**
- session_id: SDK session identifier (persistent for 7 days)
- query_id: UUID of the query_execution record from our platform
- ai_source: AI platform (chatgpt, gemini, claude, perplexity, grok)
- confidence: Attribution confidence (0.0-1.0)
- attribution_method: How attribution was determined (url_parameter, cookie, etc.)

**Response:**
Returns attribution session details including first_seen_at and created flag.

## Headers

- `X-API-Key` string

## Request body

- AttributionLinkRequest: Request to link a session to a query execution for attribution.
  - `session_id` string, required: SDK session identifier
  - `query_id` string, required: Query execution UUID
  - `ai_source` string, required: AI platform (chatgpt, gemini, claude, etc.)
  - `confidence` number, required: Attribution confidence (0.0-1.0)
  - `attribution_method` string: How attribution was determined

## Response `200`

Successful Response

- AttributionLinkResponse: Response after linking session to query.
  - `session_id` string, required
  - `query_id` string, required
  - `ai_source` string, required
  - `confidence` number, required
  - `attribution_method` string, required
  - `first_seen_at` string, date-time, required
  - `last_seen_at` string, date-time, required
  - `created` boolean, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/sig/apis/ai-visibility-intelligence-api.md) · [All operations](https://skmtc.dev/sig/apis/ai-visibility-intelligence-api/llms.txt) · [OpenAPI document](https://skmtc.dev/sig/apis/ai-visibility-intelligence-api/revisions/3ec39f9be9e0?raw)