Přejít na hlavní obsah
POST
/
api
/
chat
/
{chatId}
/
publish
Publish Message
curl --request POST \
  --url https://macaly.com/api/chat/{chatId}/publish \
  --header 'Authorization: Bearer <token>'
Odešle novou zprávu do existujícího chatu a pokračuje v konverzaci.

​
Požadavek

POST /api/chat/{chatId}/publish

​
Hlavičky

HlavičkaPovinnáPopis
AuthorizationAnoBearer macaly_...
Content-TypeAnoapplication/json

​
Parametry cesty

ParametrTypPopis
chatIdstringID chatu

​
Parametry těla požadavku

PoleTypPovinnéVýchozí hodnotaPopis
contentstringPodmíněně-Zpráva / prompt uživatele. Povinné, pokud resume není true
streambooleanNetruePokud false, vrátí JSON místo streamu
agentMode"auto" | "fast" | "smart"Ne"auto"Poměr mezi rychlostí a kvalitou AI agenta
executionMode"auto" | "planning" | "build"Ne"auto"Režim, v jakém AI agent pracuje
model"sonnet-4-5" | "sonnet-4-6" | "opus-4-5" | "opus-4-6"Ne-Konkrétní AI model. Pokud neupřesníte, použije se model nastavený pro tým
reasoningEffort"medium" | "high"Ne-Určuje, jak hluboce má model přemýšlet
resumebooleanNefalsePokud true, obnoví zastavenou konverzaci bez přidání nového obsahu
experimental_attachmentsarrayNe[]Přílohy souborů (formát viz Create Chat)
Pokud je resume nastaveno na true, nelze současně posílat content ani experimental_attachments. Slouží k obnovení dříve zastavené konverzace.

​
Příklad požadavku

curl -X POST "https://www.macaly.com/api/chat/abc123def456/publish" \
  -H "Authorization: Bearer macaly_abc123..." \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Add a dark mode toggle to the header",
    "stream": false
  }'

​
Odpověď

​
JSON odpověď (při stream: false)

{
  "chatId": "abc123def456",
  "streamId": "stream_xyz789",
  "assistantMessageId": "msg_123"
}
Následně můžete sledovat průběh pomocí endpointu Get Status.

​
Streaming odpověď (při stream: true, výchozí)

2:[{"chatId":"abc123def456"}]
0:"Analyzing your request..."
...

​
Stavové kódy

KódPopis
200Úspěch – zpráva odeslána
400Neplatný požadavek
401Neplatný nebo chybějící API klíč
402Nedostatek kreditů
403Chat nepatří tomuto týmu
404Chat nenalezen
429Překročen limit požadavků
500Chyba serveru
503Server je zaneprázdněn, zkuste to za chvíli

​
Postup

Typický postup bez použití streamování:
  1. Odešlete zprávu s stream: false
  2. Sledujte průběh pomocí GET /api/chat/{chatId}/status, dokud není stav completed
  3. Opakujte pro další zprávy