Start local chat session

POST

https://api.synup.com/api/v4/local-post-ideas/start-chat-session

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.

Request

Header Params

Body Params application/json

Example

{
    "locationId": "TG9jYXRpb246MQ==",
    "mode": "fast",
    "intent": "idea"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://api.synup.com/api/v4/local-post-ideas/start-chat-session' \
--header 'Synup-Version: 2026-04-17' \
--header 'Authorization: API T9V35W3xxxxxxxxxxx' \
--header 'Content-Type: application/json' \
--data '{
    "locationId": "TG9jYXRpb246MQ==",
    "mode": "fast",
    "intent": "idea"
}'

Responses

🟢200

application/json

Successful response

Bodyapplication/json

Example

{
    "data": {
        "startLocalChatSession": {
            "success": true,
            "session": {
                "id": "string",
                "locationId": 0,
                "mode": "string",
                "status": "string",
                "messageCount": 0,
                "title": "string",
                "subjectType": "string",
                "subjectId": "string",
                "createdAt": "string",
                "updatedAt": "string"
            },
            "suggestions": [
                "string"
            ],
            "error": {
                "message": "string",
                "code": "string",
                "contextInfo": [
                    {
                        "key": "string",
                        "value": "string"
                    }
                ]
            }
        }
    }
}

🟠401

Modified at 2026-07-14 18:58:30

Set location image credits

Switch local chat mode