Skip to main content
GET
/
api
/
campaigns
/
ai-chat-sessions
/
{id}
Get a campaign AI chat session
curl --request GET \
  --url https://app.puffle.ai/api/campaigns/ai-chat-sessions/{id} \
  --header 'Authorization: Bearer <token>'
{
  "session": {
    "id": "d1d1d1d1-1111-1111-1111-111111111111",
    "user_id": "11111111-1111-1111-1111-111111111111",
    "campaign_id": "8c2b2d4e-e29b-41d4-a716-446655440000",
    "node_id": "bbbb1111-1111-1111-1111-111111111111",
    "title": "Intro email to VPs of Sales",
    "messages": [
      {
        "role": "user",
        "content": "Write an intro email for enterprise VPs of Sales"
      },
      {
        "role": "assistant",
        "content": "Got it — here's a skeleton we can iterate on."
      }
    ],
    "draft_subject": "Quick question about {{company}}",
    "draft_body": "Hi {{first_name}}, ...",
    "skeleton": {
      "hook": "pattern-interrupt question",
      "value_prop": "15 min to outbound ROI"
    },
    "skeleton_history": [],
    "draft_history": [],
    "framework_version": 1,
    "generated_examples": null,
    "task_status": null,
    "created_at": "2026-04-22T10:00:00Z",
    "updated_at": "2026-04-22T10:05:00Z"
  }
}

​
Overview

Returns the full session row — the single source of truth for a campaign AI chat. Every field the framework LLM reads or writes (messages, skeleton, drafts, generated examples, task status) lives on this row. This is the polling target after POST .../turn and POST .../generate-examples — watch task_status return to null and the content fields update.
This operation shares the URL path /api/campaigns/ai-chat-sessions/{id} with other verbs. See Update a campaign AI chat session to modify, or Delete a campaign AI chat session to remove.

​
AI agent notes

Polling cadence. After POST .../turn or POST .../generate-examples, poll this endpoint every 2 to 5 s while task_status !== null. Chat turns usually complete within 10 to 30 s; example generation takes longer (scales with lead count).

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
id
string<uuid>
required

AI chat session UUID

Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$

Response

Session detail.

​
session
object
required

Canonical campaign AI chat session. One session drafts one email (one sequence node) through a back-and-forth chat with the framework LLM.