Chat

Ask questions grounded in one or more recordings' transcripts.

Ask a question grounded in the transcripts of up to 10 recordings. The answer generates asynchronously — poll GET /v1/chat/:id until status is "completed".

Tier: automation. Base URL https://app.castmagic.io.

Start a chat

POST https://app.castmagic.io/v1/chat

Request Body

Name	Type	Description
message*	String	The question to ask
recording_ids*	String[]	1–10 recording ids to ground the answer in

202: Accepted

{
    "chat_id": "c1...",
    "status": "queued"
}

400: Bad Request Too many recordings

{ "error": "recording_ids is capped at 10 recordings" }

Fetch a chat

GET https://app.castmagic.io/v1/chat/:id

Poll until status is "completed"; the response text is then in answer.

200: OK completed

{
    "chat_id": "c1...",
    "status": "completed",
    "answer": "The main pricing objections were...",
    "recording_ids": ["e1...", "e2..."]
}

200: OK still processing

{
    "chat_id": "c1...",
    "status": "queued",
    "answer": null,
    "recording_ids": ["e1...", "e2..."]
}