---
title: "Add Conversation Turn"
method: POST
path: "/api/v1/conversations/{conversation_id}/turns"
tags: ["conversations"]
---

# Add Conversation Turn

`POST /api/v1/conversations/{conversation_id}/turns`

## 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/v1/conversations/{conversation_id}/turns`
- Auth: HTTP bearer

Add a new turn to an existing conversation.

## Path parameters

- `conversation_id` string, uuid, required

## Cookies

- `access_token` string, nullable

## Request body

- ConversationTurnCreate: Schema for creating a new conversation turn.
  - `query_text` string, required: The query text for this turn

## Response `201`

Successful Response

- ConversationTurnResponse: Schema for conversation turn response.
  - `query_text` string, required: The query text for this turn
  - `id` string, uuid, required
  - `conversation_id` string, uuid, required
  - `turn_number` integer, required
  - `query_execution_id` string, uuid, nullable
  - `mentioned` boolean, nullable
  - `explicit_rank` integer, nullable
  - `implicit_rank` integer, nullable
  - `recommendation_strength` number, nullable
  - `sentiment` string, nullable
  - `sentiment_score` number, nullable
  - `raw_answer` string, nullable
  - `turn_metadata` object
  - `created_at` string, date-time, 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)