---
title: "Post Stream"
method: POST
path: "/api/py/chat/stream"
---

# Post Stream

`POST /api/py/chat/stream`

## Request

- Base URL: `https://api.getauctor.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.getauctor.com/api/py/chat/stream`
- Auth: none declared

## Request body

- PostChatStreamRequest
  - `user_id` string, required
  - `organization_id` string, required
  - `turn_request_id` string, uuid, nullable
  - `message` string, nullable
  - `session` object, nullable
  - `draft_session_id` string, nullable
  - `chat_state` ChatState
    - `user_name` string, required
    - `organization_name` string, required
    - `timezone` string
    - `page` string, nullable
    - `path` string, nullable
    - `uri` string, nullable
    - `ancestor_uris` string[], nullable
    - `ancestor_names` string[], nullable
  - `notifications` string[], nullable
  - `file_attachments` FileAttachment[], nullable
    - `id` string, required
    - `file_name` string, required
    - `bucket_path` string, required
  - `retry_back` integer, nullable
  - `retry_turn_id` string, uuid, nullable
  - `client_type` 'chat' | 'word' | 'powerpoint'
  - `answers` object, nullable
  - `tiptap_content` object, nullable
  - `model_override` ChatModelOverrideRequest
    - `model` string, required
    - `mode` string
  - `queued_message_id` string, uuid, nullable
  - `steer` boolean, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-29** `7aeb7f48db21`: 2 info
  - added the new optional request property `queued_message_id`
  - added the new optional request property `steer`
- **2026-10-23** `c916e63d6cb2`: 1 info
  - added the new optional request property `retry_turn_id`
- **2026-10-10** `c06a3e3b8fb3`: 1 info
  - added the new optional request property `turn_request_id`
- **2026-09-29** `524965130320`: 2 breaking, 1 info
  - the request property `file_attachments/anyOf[subschema #1]/items/bucket_path` became required
  - the `file_attachments/anyOf[subschema #1]/items/bucket_path` request property's minLength was increased from `0` to `1`
  - the `bucket_path` request property default value `` was removed
- **2026-09-01** `aeb6faa3b8f0`: 7 warning, 3 info
  - removed the request property `chat_id`
  - removed the request property `chat_overrides`
  - removed the request property `chat_state/anyOf[subschema #1: ChatState]/mentions`
  - removed the request property `chat_state/anyOf[subschema #1: ChatState]/preferences`
  - …6 more

[Operation history](https://skmtc.dev/getauctor/apis/getauctor-api/changes/api/py/chat/stream/post.md)

---

[API](https://skmtc.dev/getauctor/apis/getauctor-api.md) - [All operations](https://skmtc.dev/getauctor/apis/getauctor-api/llms.txt) - [OpenAPI document](https://skmtc.dev/getauctor/apis/getauctor-api/revisions/be39c59c13f6?raw)