---
title: "Start local chat session"
method: POST
path: "/local-post-ideas/start-chat-session"
tags: ["Local Post Ideas"]
---

# Start local chat session

`POST /local-post-ideas/start-chat-session`

## Request

- Base URL: `https://api.synup.com/api/v4`
- URL: `https://api.synup.com/api/v4/local-post-ideas/start-chat-session`
- Auth: none required
- TypeScript: <https://skmtc.dev/synup/apis/synup-api/docs/local-post-ideas/start-chat-session/post.ts> (a function with typed inputs; its response is checked against the schema)

Starts a new AI post-idea chat session for a location. Optionally seed the session with an `intent`, a `mode` (e.g. fast), and a subject (`subjectType`/`subjectId`) to anchor the conversation to an existing idea or series.

## Headers

- `Synup-Version` string, required
- `Authorization` string, required

## Request body

- StartLocalChatSessionRequest
  - `locationId` string, required: Relay-encoded location ID.
  - `intent` string: Conversation intent (e.g. idea).
  - `mode` string: Generation mode (e.g. fast).
  - `subjectType` string
  - `subjectId` string

## Response `200`

Successful response

- object
  - `data` object
    - `startLocalChatSession` LocalChatSessionResponseV3
      - `success` boolean
      - `session` LocalChatSessionV3
        - `id` string
        - `locationId` integer
        - `mode` string
        - `status` string
        - `messageCount` integer
        - `title` string
        - `subjectType` string
        - `subjectId` string
        - `createdAt` string
        - `updatedAt` string
      - `suggestions` string[]
      - `error` LocalErrorV3
        - `message` string
        - `code` string
        - `contextInfo` object[]
          - `key` string
          - `value` string

## Other responses

- `401`: Unauthorized - Invalid or missing API key

---

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