---
title: "Sessions Turns Create"
method: POST
path: "/agents/sessions/{session_id}/turns/"
tags: ["agents"]
---

# Sessions Turns Create

`POST /agents/sessions/{session_id}/turns/`

Create a turn within an agent chat session (streams SSE response).

POST /agents/sessions/<session_id>/turns/
POST /agents/chat/

Request body (JSON):
    input (list, required): Full conversation messages.
        Last message must have role ``user``.
        Messages may include ``file_ids`` (list[str]) to attach files
        uploaded via POST /agents/files/.
    timezone (str, optional): IANA timezone, defaults to ``UTC``.
    conversation (str, optional): Conversation ID for persistence.
    parent_message_id (str, optional): Message ID to parent this
        turn under in the conversation tree.

Response: Server-Sent Events stream.

## Path parameters

- `session_id` string, required

## Headers

- `Authorization` string, required

## Request body

- TurnRequestRequest
  - `input` object[], required
  - `timezone` string
  - `conversation` string, nullable
  - `parent_message_id` string, nullable
  - `model` string, nullable
  - `page_context` object, nullable
  - `skill_ids` string[]
  - `is_read_only` boolean

## Response `200`

No response body

- AgentsSessionsTurnsCreateResponse200 — Empty response body

---

[API](https://skmtc.net/keywordsai/apis/api-reference.md) · [All operations](https://skmtc.net/keywordsai/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/keywordsai/api-reference/versions/c26d550029f8/schema)