API Reference

{
  "status": "healthy",
  "service": "archivist-api",
  "version": "1.0.0",
  "environment": "production",
  "port": 8000,
  "timestamp": "2025-01-15T10:30:00.123456Z"
}

{
  "monthlyTokensRemaining": 12345,
  "hourlyTokensRemaining": 6789,
  "launchPromoActive": false
}

{
  "detail": "Missing required parameter: campaign_id"
}

{
  "answer": "Cassius Traven is a shadowy information broker who operates in the city's underground...",
  "citations": [
    {
      "citation_id": "S1",
      "source_type": "timeline",
      "source_id": "beat-abc123",
      "title": "Session 4 — The Sunken Manor",
      "session_number": 4,
      "excerpt": "Cassius revealed his true identity as..."
    }
  ],
  "monthlyTokensRemaining": 12345,
  "hourlyTokensRemaining": 6789
}

{
  "detail": "messages is required"
}

{
  "detail": "Invalid API key"
}

{
  "detail": "asker_id user does not have access to this world"
}

{
  "detail": "asker_id user not found"
}

{
  "detail": "Monthly token limit exceeded"
}

{
  "data": [
    {
      "id": "camp_abc123",
      "title": "Shadows of Elyndor",
      "description": "A dark fantasy campaign",
      "system": "D&D 5e",
      "public": false,
      "created_at": "2024-01-15T10:30:00Z"
    }
  ],
  "total": 1,
  "page": 1,
  "size": 20,
  "pages": 1
}

{
  "detail": "Invalid API key"
}

{
  "id": "camp_abc123",
  "title": "Shadows of Elyndor",
  "description": "A dark fantasy campaign",
  "system": "D&D 5e",
  "public": false,
  "created_at": "2024-01-15T10:30:00Z"
}

{
  "detail": "Campaign not found"
}

{
  "detail": "Invalid API key"
}

{
  "id": "camp_new123",
  "title": "My Epic Campaign",
  "description": "A thrilling adventure",
  "system": "D&D 5e",
  "public": false,
  "created_at": "2024-01-25T16:45:00Z"
}

{
  "detail": "title is required"
}

{
  "detail": "Invalid API key"
}

{
  "id": "camp_abc123",
  "title": "Updated Campaign Name",
  "description": "A dark fantasy campaign",
  "system": "D&D 5e",
  "public": false,
  "created_at": "2024-01-15T10:30:00Z"
}

{
  "detail": "Campaign not found"
}

{
  "detail": "Invalid API key"
}

(no content)

{
  "detail": "Campaign not found"
}

{
  "detail": "Invalid API key"
}

{
  "campaign_id": "camp_abc123",
  "characters": 12,
  "sessions": 24,
  "moments": 156,
  "beats": 48,
  "factions": 5,
  "locations": 18,
  "items": 32
}

{
  "detail": "Campaign not found"
}

{
  "characters": [
    { "id": "char_123", "characterName": "Elara Windsong", "type": "PC", "image": null }
  ],
  "factions": [],
  "locations": [
    { "id": "loc_456", "name": "Thornwood", "type": "forest", "image": null }
  ],
  "items": [],
  "sessions": [
    { "id": "session_123", "title": "Into the Thornwood", "session_number": 4, "image": null }
  ],
  "recaps": [
    {
      "id": "session_123",
      "title": "Into the Thornwood",
      "session_number": 4,
      "image": null,
      "summary": "The party tracked muddy footprints north from Briarton."
    }
  ],
  "quests": [
    { "id": "quest_789", "questName": "Find the missing courier", "status": "in-progress" }
  ],
  "journals": [
    { "id": "journal_012", "title": "Thornwood field notes", "image": null }
  ]
}

{
  "data": [
    {
      "id": "link_123",
      "campaign_id": "camp_abc123",
      "from_id": "char_456",
      "from_type": "Character",
      "to_id": "char_789",
      "to_type": "Character",
      "alias": "friends",
      "created_at": "2024-01-15T10:30:00Z"
    }
  ],
  "total": 25,
  "page": 1,
  "size": 20,
  "pages": 2
}

{
  "id": "link_new123",
  "campaign_id": "camp_abc123",
  "from_id": "char_456",
  "from_type": "Character",
  "to_id": "loc_789",
  "to_type": "Location",
  "alias": "home",
  "created_at": "2024-01-25T16:45:00Z"
}

{
  "detail": "Target Character not found"
}

{
  "detail": "Link source and target must belong to the same world"
}

{
  "id": "link_123",
  "campaign_id": "camp_abc123",
  "from_id": "char_456",
  "from_type": "Character",
  "to_id": "loc_789",
  "to_type": "Location",
  "alias": "updated label",
  "created_at": "2024-01-15T10:30:00Z"
}

{
  "detail": "Link not found"
}

{
  "detail": "Link alias cannot be empty"
}

(no content)

{
  "detail": "Link not found"
}

{
  "data": [
    {
      "id": "char_123",
      "campaign_id": "camp_abc123",
      "character_name": "Thorin Ironforge",
      "player_name": null,
      "player": {
        "id": "speaker_123",
        "name": "John Smith",
        "handle": "johnsmith",
        "roles": ["Player"],
        "campaign_id": "camp_abc123",
        "created_at": "2024-01-10T08:00:00Z"
      },
      "description": "A brave dwarf warrior",
      "type": "PC",
      "merge": false,
      "created_at": "2024-01-15T10:30:00Z"
    }
  ],
  "total": 1,
  "page": 1,
  "size": 20,
  "pages": 1
}

{
  "detail": "campaign_id is required"
}

{
  "detail": "Invalid API key"
}

{
  "id": "char_123",
  "campaign_id": "camp_abc123",
  "character_name": "Thorin Ironforge",
  "character_aliases": ["Thorin", "Ironforge"],
  "player_name": null,
  "player": {
    "id": "speaker_123",
    "name": "John Smith",
    "handle": "johnsmith",
    "roles": ["Player"],
    "campaign_id": "camp_abc123",
    "created_at": "2024-01-10T08:00:00Z"
  },
  "description": "A brave dwarf warrior",
  "backstory": "Raised in the halls beneath Emberpeak...",
  "type": "PC",
  "merge": false,
  "created_at": "2024-01-15T10:30:00Z"
}

{
  "detail": "Character not found"
}

{
  "id": "char_new456",
  "campaign_id": "camp_abc123",
  "character_name": "Thorin Ironforge",
  "character_aliases": ["Thorin", "Ironforge"],
  "player_name": null,
  "player": null,
  "description": "A brave dwarf warrior",
  "backstory": "Raised in the halls beneath Emberpeak...",
  "type": "PC",
  "merge": false,
  "created_at": "2024-01-25T16:45:00Z"
}

{
  "detail": "speaker_id must belong to the same world"
}

{
  "detail": "image must be an HTTPS URL"
}

{
  "detail": "Campaign not found"
}

{
  "id": "char_123",
  "campaign_id": "camp_abc123",
  "character_name": "Thorin Ironforge the Bold",
  "character_aliases": ["Thorin", "The Bold"],
  "player_name": null,
  "player": {
    "id": "speaker_123",
    "name": "John Smith",
    "handle": "johnsmith",
    "roles": ["Player"],
    "campaign_id": "camp_abc123",
    "created_at": "2024-01-10T08:00:00Z"
  },
  "description": "A brave dwarf warrior with a legendary magic axe",
  "backstory": "Raised in the halls beneath Emberpeak and sworn to the old kings...",
  "type": "PC",
  "merge": false,
  "created_at": "2024-01-15T10:30:00Z"
}

{
  "detail": "Character name cannot match the linked speaker name"
}

{
  "detail": "Character not found"
}

(no content)

{
  "detail": "Character not found"
}

{
  "data": [
    {
      "id": "session_123",
      "campaign_id": "camp_abc123",
      "type": "audioUpload",
      "title": "The Lost Mines of Phandelver",
      "summary": "The party explored the ancient mines...",
      "notes": null,
      "session_date": "2024-01-20T19:00:00Z",
      "image": null,
      "index": 5,
      "public": false,
      "pbp_start_msg_url": null,
      "pbp_end_msg_url": null,
      "created_at": "2024-01-20T22:30:00Z",
      "updated_at": null
    }
  ],
  "total": 24,
  "page": 1,
  "size": 20,
  "pages": 2
}

{
  "detail": "campaign_id is required"
}

{
  "id": "session_123",
  "campaign_id": "camp_abc123",
  "type": "audioUpload",
  "title": "The Lost Mines of Phandelver",
  "summary": "The party explored the ancient mines...",
  "notes": null,
  "session_date": "2024-01-20T19:00:00Z",
  "image": null,
  "index": 5,
  "public": false,
  "pbp_start_msg_url": null,
  "pbp_end_msg_url": null,
  "created_at": "2024-01-20T22:30:00Z",
  "updated_at": null,
  "beats": null,
  "moments": null
}

{
  "detail": "Session not found"
}

{
  "id": "cast_analysis_123",
  "session_id": "session_123",
  "analysis": {
    "coreSessionMetrics": {
      "totalLines": 1284,
      "totalWords": 18201,
      "avgWordsPerLine": 14.18,
      "totalTurns": 1284,
      "avgTurnWords": 14.18
    },
    "talkShare": {
      "GM": 0.42,
      "Player 1": 0.31,
      "Player 2": 0.27
    }
  },
  "pdfPageCount": 4,
  "pdfSavedAt": "2026-08-30T18:12:00Z",
  "created_at": "2025-01-12T20:30:00Z",
  "updated_at": "2025-01-12T20:30:00Z"
}

{
  "detail": "Cast analysis not found"
}

{
  "summary": "The party ventured into the **Thornwood** seeking the missing courier...",
  "sessionOutline": "### Entering the Thornwood\n- The party tracked muddy footprints north from Briarton\n- They discovered an abandoned camp with signs of a struggle\n\n### The Ambush\n- Bandits attacked from the tree line\n- The party captured the bandit leader, **Harsk**",
  "encounters": [
    {
      "title": "Ambush at the Thornwood Camp",
      "bullets": [
        "Three bandits attacked from concealed positions in the tree line",
        "The ranger flanked the enemies using the dense underbrush",
        "The bandit leader Harsk was subdued and captured alive",
        "One bandit escaped north toward the river crossing"
      ]
    }
  ],
  "characterSpotlight": [
    {
      "name": "Elara Windsong",
      "description": "Led the interrogation of the captured bandit leader. Negotiated safe passage through the Thornwood in exchange for Harsk's release.",
      "bullets": [
        "Identified the bandit camp through tracking",
        "Secured critical intelligence about the courier's destination"
      ]
    }
  ],
  "otherEntitySpotlight": [
    {
      "name": "Harsk",
      "description": "Bandit leader captured during the Thornwood ambush; revealed the courier was taken to Ashenmere."
    }
  ],
  "items": [
    {
      "name": "Courier's Sealed Letter",
      "description": "A wax-sealed letter bearing the sigil of House Valdris, found discarded at the abandoned camp."
    }
  ],
  "valuableInformation": [
    {
      "info": "The courier was taken alive to Ashenmere by a group working for an unknown patron."
    },
    {
      "info": "Harsk mentioned a 'tall woman in grey' who paid for the abduction."
    }
  ],
  "partyStatusAndNextSteps": {
    "partyStatus": {
      "summary": "The party is camped at the edge of the Thornwood, lightly wounded after the bandit ambush.",
      "bullets": [
        "Harsk has been released per the negotiated agreement",
        "The sealed letter may contain information about the courier's mission"
      ]
    },
    "nextSteps": {
      "summary": "The party intends to travel north to Ashenmere to locate and rescue the missing courier."
    }
  },
  "moments": [
    {
      "label": "A Tense Negotiation",
      "content": "Elara convinced Harsk to reveal the courier's location in exchange for his freedom."
    }
  ],
  "pdfPageCount": 3,
  "pdfSavedAt": "2026-08-30T18:12:00Z"
}

{
  "detail": "Handout not found for this session"
}

{
  "version": 1,
  "created_at": "2025-03-10T06:01:11.195Z",
  "metadata": {
    "session_id": "session-123",
    "session_type": "discordVoice",
    "campaign_id": "camp-abc",
    "world_title": "Adventures in the Realm",
    "world_language": "en",
    "session_date": "2025-03-10T03:28:30.266Z",
    "speakers": [
      "Joshua Perez (GM)",
      "Hannah Gray (Zekaria [PC])"
    ],
    "speaker_count": 2,
    "source_type": "discordVoice",
    "created_at": "2025-03-10T06:01:11.195Z"
  },
  "utterances": [
    {
      "speaker_label": "Joshua Perez (GM)",
      "transcript": "Alright, let's pick up where we left off last time.",
      "start": 0,
      "end": 3.2,
      "said_at": "2025-03-10T03:28:35.170Z"
    },
    {
      "speaker_label": "Hannah Gray (Zekaria [PC])",
      "transcript": "Sounds good. I think we were heading toward the ruins.",
      "start": 3.5,
      "end": 6.8,
      "said_at": "2025-03-10T03:28:38.670Z"
    }
  ],
  "text": "Joshua Perez (GM): Alright, let's pick up where we left off...",
  "stats": {
    "char_count": 143672,
    "tokens": 40104,
    "utterance_count": 1797
  }
}

# Transcript

## Metadata

- **Session ID**: session-123
- **Campaign**: Adventures in the Realm
- **Session Date**: 2025-03-10T03:28:30.266Z
- **Session Type**: discordVoice
- **Speakers**: Joshua Perez (GM), Hannah Gray (Zekaria [PC])
- **Speaker Count**: 2

## Statistics

- **Utterances**: 1,797
- **Characters**: 143,672
- **Tokens**: 40,104

## Transcript

**Joshua Perez (GM)** [0:00]: Alright, let's pick up where we left off last time.

**Hannah Gray (Zekaria [PC])** [0:03]: Sounds good. I think we were heading toward the ruins.

...

{
  "detail": "Transcript not found for this session"
}

{
  "id": "session_123",
  "campaign_id": "camp_abc123",
  "type": "audioUpload",
  "title": "Updated Session Title",
  "summary": "Updated summary...",
  "notes": null,
  "session_date": "2024-01-20T19:00:00Z",
  "image": null,
  "index": 5,
  "public": false,
  "pbp_start_msg_url": null,
  "pbp_end_msg_url": null,
  "created_at": "2024-01-20T22:30:00Z",
  "updated_at": "2024-01-20T23:00:00Z"
}

{
  "detail": "Session not found"
}

{
  "data": [
    {
      "id": "beat_123",
      "campaign_id": "camp_abc123",
      "game_session_ids": ["session_456"],
      "game_session_id": "session_456",
      "label": "The Final Battle",
      "type": "major",
      "description": "The party confronts the dark lord",
      "index": 1,
      "parent_id": null,
      "metadata": {},
      "created_at": "2024-01-20T22:30:00Z",
      "updated_at": null
    }
  ],
  "total": 48,
  "page": 1,
  "size": 20,
  "pages": 3
}

[
  {
    "id": "beat_123",
    "campaign_id": "camp_abc123",
    "label": "Act I",
    "type": "major",
    "index": 0,
    "linkedEntities": {
      "characters": [],
      "factions": [],
      "locations": [],
      "items": []
    },
    "children": [
      {
        "id": "beat_124",
        "label": "The ambush",
        "type": "minor",
        "index": 0,
        "linkedEntities": {
          "characters": ["char_123"],
          "factions": [],
          "locations": ["loc_456"],
          "items": []
        },
        "children": []
      }
    ]
  }
]

{
  "detail": "campaign_id or session_id is required"
}

{
  "id": "beat_123",
  "campaign_id": "camp_abc123",
  "game_session_ids": ["session_456"],
  "game_session_id": "session_456",
  "label": "The Final Battle",
  "type": "major",
  "description": "The party confronts the dark lord",
  "index": 1,
  "parent_id": null,
  "metadata": {},
  "created_at": "2024-01-20T22:30:00Z",
  "updated_at": null
}

{
  "detail": "Beat not found"
}

{
  "id": "beat_new789",
  "campaign_id": "camp_abc123",
  "game_session_id": "session_456",
  "label": "The Final Battle",
  "type": "major",
  "description": null,
  "index": 1,
  "parent_id": null,
  "created_at": "2024-01-25T16:45:00Z"
}

{
  "detail": "label, type, and campaign_id are required"
}

{
  "id": "beat_123",
  "campaign_id": "camp_abc123",
  "game_session_id": "session_456",
  "label": "Updated Beat Label",
  "type": "major",
  "description": "Updated description",
  "index": 2,
  "parent_id": null,
  "created_at": "2024-01-20T22:30:00Z"
}

{
  "detail": "Beat not found"
}

(no content)

{
  "detail": "Beat not found"
}

{
  "data": [
    {
      "id": "moment_123",
      "campaign_id": "camp_abc123",
      "session_id": "session_456",
      "label": "The stand at the gate",
      "content": "Thorin holds the line as the gate shudders.",
      "image": "https://cdn.example.com/moments/gate.jpg",
      "index": 0,
      "categories": ["key-moment"],
      "kind": "key-moment",
      "metadata": { "style": "verdant", "variant": "landscape" },
      "created_at": "2024-01-20T22:30:00Z",
      "updated_at": null
    }
  ],
  "total": 156,
  "page": 1,
  "size": 20,
  "pages": 8
}

{
  "data": [
    {
      "id": "moment_123",
      "label": "The stand at the gate",
      "image": "https://cdn.example.com/moments/gate.jpg",
      "session_id": "session_456",
      "created_at": "2024-01-20T22:30:00Z",
      "categories": ["key-moment"]
    }
  ],
  "total": 156,
  "page": 1,
  "size": 20,
  "pages": 8
}

{
  "id": "moment_123",
  "campaign_id": "camp_abc123",
  "session_id": "session_456",
  "label": "The stand at the gate",
  "content": "Thorin holds the line as the gate shudders.",
  "image": "https://cdn.example.com/moments/gate.jpg",
  "index": 0,
  "categories": ["key-moment"],
  "kind": "key-moment",
  "metadata": { "style": "verdant", "variant": "landscape" },
  "created_at": "2024-01-20T22:30:00Z",
  "updated_at": "2024-01-21T10:00:00Z"
}

{
  "detail": "Moment not found"
}

{
  "id": "moment_new999",
  "campaign_id": "camp_abc123",
  "session_id": "session_456",
  "label": "The stand at the gate",
  "content": "Thorin holds the line.",
  "image": null,
  "index": 0,
  "categories": ["key-moment"],
  "kind": "key-moment",
  "metadata": { "style": "verdant", "variant": "landscape" },
  "created_at": "2024-01-25T16:45:00Z",
  "updated_at": null
}

{
  "detail": "campaign_id and session_id are required"
}

{
  "id": "moment_123",
  "campaign_id": "camp_abc123",
  "session_id": "session_456",
  "label": "Updated Label",
  "content": "Updated content...",
  "image": null,
  "index": 0,
  "categories": ["key-moment"],
  "kind": "key-moment",
  "metadata": { "style": "verdant" },
  "created_at": "2024-01-20T22:30:00Z",
  "updated_at": "2024-01-25T16:45:00Z"
}

{
  "detail": "Moment not found"
}

(no content)

{
  "detail": "Moment not found"
}

{
  "data": [
    {
      "id": "award_123",
      "campaign_id": "camp_abc123",
      "session_id": "session_456",
      "title": "MVP of the Gate",
      "description": "Held the line while the party regrouped.",
      "character_name": "Thorin",
      "player_name": "Alex",
      "tone_mode": "default",
      "award_mode": "moment",
      "style": "verdant",
      "variant": "square-v2",
      "custom_theme": null,
      "order_index": 1,
      "created_at": "2024-01-20T22:30:00Z",
      "updated_at": null
    }
  ],
  "total": 3,
  "page": 1,
  "size": 20,
  "pages": 1
}

{
  "detail": "campaign_id or session_id is required"
}

{
  "id": "award_123",
  "campaign_id": "camp_abc123",
  "session_id": "session_456",
  "title": "MVP of the Gate",
  "description": "Held the line while the party regrouped.",
  "character_name": "Thorin",
  "player_name": "Alex",
  "tone_mode": "default",
  "award_mode": "moment",
  "style": "verdant",
  "variant": "square-v2",
  "custom_theme": null,
  "order_index": 1,
  "created_at": "2024-01-20T22:30:00Z",
  "updated_at": null
}

{
  "detail": "Hero award not found"
}

{
  "id": "award_new999",
  "campaign_id": "camp_abc123",
  "session_id": "session_456",
  "title": "MVP of the Gate",
  "description": "Held the line while the party regrouped.",
  "character_name": "Thorin",
  "player_name": "Alex",
  "tone_mode": "default",
  "award_mode": "moment",
  "style": "verdant",
  "variant": "square-v2",
  "custom_theme": null,
  "order_index": 1,
  "created_at": "2024-01-25T16:45:00Z",
  "updated_at": null
}

{
  "detail": "session_id is required"
}

{
  "id": "award_123",
  "campaign_id": "camp_abc123",
  "session_id": "session_456",
  "title": "Updated Award",
  "description": "Updated description",
  "character_name": "Thorin",
  "player_name": "Alex",
  "tone_mode": "default",
  "award_mode": "moment",
  "style": "verdant",
  "variant": "square-v2",
  "custom_theme": null,
  "order_index": 1,
  "created_at": "2024-01-20T22:30:00Z",
  "updated_at": "2024-01-25T16:45:00Z"
}

{
  "detail": "Hero award not found"
}

(no content)

{
  "detail": "Hero award not found"
}

{
  "data": [
    {
      "id": "quote_123",
      "campaign_id": "camp_abc123",
      "session_id": "session_456",
      "text": "I am Thorin, son of Thrain.",
      "speaker": "Thorin",
      "character_name": "Thorin",
      "context": "Standing at the shattered gate.",
      "style": "verdant",
      "custom_theme": null,
      "order_index": 0,
      "pipeline_id": "pipeline_789",
      "recap_set_id": null,
      "created_at": "2024-01-20T22:30:00Z",
      "updated_at": null
    }
  ],
  "total": 12,
  "page": 1,
  "size": 20,
  "pages": 1
}

{
  "detail": "campaign_id or session_id is required"
}

{
  "id": "quote_123",
  "campaign_id": "camp_abc123",
  "session_id": "session_456",
  "text": "I am Thorin, son of Thrain.",
  "speaker": "Thorin",
  "character_name": "Thorin",
  "context": "Standing at the shattered gate.",
  "style": "verdant",
  "custom_theme": null,
  "order_index": 0,
  "pipeline_id": "pipeline_789",
  "recap_set_id": null,
  "created_at": "2024-01-20T22:30:00Z",
  "updated_at": null
}

{
  "detail": "Quote not found"
}

{
  "id": "quote_new999",
  "campaign_id": "camp_abc123",
  "session_id": "session_456",
  "text": "I am Thorin, son of Thrain.",
  "speaker": "Thorin",
  "character_name": "Thorin",
  "context": "Standing at the shattered gate.",
  "style": "verdant",
  "custom_theme": null,
  "order_index": 0,
  "pipeline_id": "pipeline_789",
  "recap_set_id": null,
  "created_at": "2024-01-25T16:45:00Z",
  "updated_at": null
}

{
  "detail": "session_id and text are required"
}

{
  "id": "quote_123",
  "campaign_id": "camp_abc123",
  "session_id": "session_456",
  "text": "Updated quote text.",
  "speaker": "Thorin",
  "character_name": "Thorin",
  "context": "Updated context",
  "style": "verdant",
  "custom_theme": null,
  "order_index": 0,
  "pipeline_id": "pipeline_789",
  "recap_set_id": null,
  "created_at": "2024-01-20T22:30:00Z",
  "updated_at": null
}

{
  "detail": "Quote not found"
}

(no content)

{
  "detail": "Quote not found"
}

{
  "data": [
    {
      "id": "spotlight_123",
      "campaign_id": "camp_abc123",
      "session_id": "session_456",
      "title": "Thorin at the Gate",
      "description": "A last stand that bought the party time.",
      "character_name": "Thorin",
      "player_name": "Alex",
      "style": "verdant",
      "custom_theme": null,
      "order_index": 0,
      "entry_type": "spotlight",
      "source_moment_id": "moment_123",
      "pipeline_id": "pipeline_789",
      "recap_set_id": null,
      "created_at": "2024-01-20T22:30:00Z",
      "updated_at": null
    }
  ],
  "total": 4,
  "page": 1,
  "size": 20,
  "pages": 1
}

{
  "detail": "campaign_id or session_id is required"
}

{
  "id": "spotlight_123",
  "campaign_id": "camp_abc123",
  "session_id": "session_456",
  "title": "Thorin at the Gate",
  "description": "A last stand that bought the party time.",
  "character_name": "Thorin",
  "player_name": "Alex",
  "style": "verdant",
  "custom_theme": null,
  "order_index": 0,
  "entry_type": "spotlight",
  "source_moment_id": "moment_123",
  "pipeline_id": "pipeline_789",
  "recap_set_id": null,
  "created_at": "2024-01-20T22:30:00Z",
  "updated_at": null
}

{
  "detail": "Spotlight not found"
}

{
  "id": "spotlight_new999",
  "campaign_id": "camp_abc123",
  "session_id": "session_456",
  "title": "Thorin at the Gate",
  "description": "A last stand that bought the party time.",
  "character_name": "Thorin",
  "player_name": "Alex",
  "style": "verdant",
  "custom_theme": null,
  "order_index": 0,
  "entry_type": "spotlight",
  "source_moment_id": null,
  "pipeline_id": "pipeline_789",
  "recap_set_id": null,
  "created_at": "2024-01-25T16:45:00Z",
  "updated_at": null
}

{
  "detail": "session_id and title are required"
}

{
  "id": "spotlight_123",
  "campaign_id": "camp_abc123",
  "session_id": "session_456",
  "title": "Updated Spotlight",
  "description": "Updated description",
  "character_name": "Thorin",
  "player_name": "Alex",
  "style": "verdant",
  "custom_theme": null,
  "order_index": 0,
  "entry_type": "spotlight",
  "source_moment_id": "moment_123",
  "pipeline_id": "pipeline_789",
  "recap_set_id": null,
  "created_at": "2024-01-20T22:30:00Z",
  "updated_at": null
}

{
  "detail": "Spotlight not found"
}

(no content)

{
  "detail": "Spotlight not found"
}

{
  "data": [
    {
      "id": "faction_123",
      "campaign_id": "camp_abc123",
      "name": "The Shadow Thieves",
      "description": "A guild of thieves operating in the shadows",
      "type": "guild",
      "merge": false,
      "created_at": "2024-01-15T10:30:00Z"
    }
  ],
  "total": 5,
  "page": 1,
  "size": 20,
  "pages": 1
}

{
  "detail": "campaign_id is required"
}

{
  "id": "faction_123",
  "campaign_id": "camp_abc123",
  "name": "The Shadow Thieves",
  "description": "A guild of thieves operating in the shadows",
  "type": "guild",
  "merge": false,
  "created_at": "2024-01-15T10:30:00Z"
}

{
  "detail": "Faction not found"
}

{
  "id": "faction_new456",
  "campaign_id": "camp_abc123",
  "name": "The Iron Brotherhood",
  "description": "A mercenary company",
  "type": "guild",
  "merge": false,
  "created_at": "2024-01-25T16:45:00Z"
}

{
  "detail": "name and campaign_id are required"
}

{
  "id": "faction_123",
  "campaign_id": "camp_abc123",
  "name": "Updated Faction Name",
  "description": "Updated description",
  "type": "guild",
  "merge": false,
  "created_at": "2024-01-15T10:30:00Z"
}

{
  "detail": "Faction not found"
}

(no content)

{
  "detail": "Faction not found"
}

{
  "data": [
    {
      "id": "loc_123",
      "campaign_id": "camp_abc123",
      "name": "The Prancing Pony",
      "description": "A cozy inn in Bree",
      "type": "tavern",
      "parent_id": "loc_456",
      "merge": false,
      "created_at": "2024-01-15T10:30:00Z"
    }
  ],
  "total": 18,
  "page": 1,
  "size": 20,
  "pages": 1
}

{
  "detail": "campaign_id is required"
}

{
  "id": "loc_123",
  "campaign_id": "camp_abc123",
  "name": "The Prancing Pony",
  "description": "A cozy inn in Bree",
  "type": "tavern",
  "parent_id": "loc_456",
  "merge": false,
  "created_at": "2024-01-15T10:30:00Z"
}

{
  "detail": "Location not found"
}

{
  "id": "loc_new789",
  "campaign_id": "camp_abc123",
  "name": "Rivendell",
  "description": "The Last Homely House",
  "type": "city",
  "parent_id": null,
  "merge": false,
  "created_at": "2024-01-25T16:45:00Z"
}

{
  "detail": "name and campaign_id are required"
}

{
  "id": "loc_123",
  "campaign_id": "camp_abc123",
  "name": "Updated Location Name",
  "description": "Updated description",
  "type": "tavern",
  "parent_id": "loc_456",
  "merge": false,
  "created_at": "2024-01-15T10:30:00Z"
}

{
  "detail": "Location not found"
}

(no content)

{
  "detail": "Location not found"
}

{
  "data": [
    {
      "id": "item_123",
      "campaign_id": "camp_abc123",
      "name": "Sting",
      "description": "An elven blade that glows blue near orcs",
      "type": "weapon",
      "merge": false,
      "created_at": "2024-01-15T10:30:00Z"
    }
  ],
  "total": 32,
  "page": 1,
  "size": 20,
  "pages": 2
}

{
  "detail": "campaign_id is required"
}

{
  "id": "item_123",
  "campaign_id": "camp_abc123",
  "name": "Sting",
  "description": "An elven blade that glows blue near orcs",
  "type": "weapon",
  "merge": false,
  "created_at": "2024-01-15T10:30:00Z"
}

{
  "detail": "Item not found"
}

{
  "id": "item_new456",
  "campaign_id": "camp_abc123",
  "name": "Anduril",
  "description": "The Flame of the West",
  "type": "weapon",
  "merge": false,
  "created_at": "2024-01-25T16:45:00Z"
}

{
  "detail": "name and campaign_id are required"
}

{
  "id": "item_123",
  "campaign_id": "camp_abc123",
  "name": "Updated Item Name",
  "description": "Updated description",
  "type": "weapon",
  "merge": false,
  "created_at": "2024-01-15T10:30:00Z"
}

{
  "detail": "Item not found"
}

(no content)

{
  "detail": "Item not found"
}

{
  "data": [
    {
      "id": "quest_123",
      "campaign_id": "camp_abc123",
      "order_index": 2,
      "quest_name": "Recover the Azure Sigil",
      "quest_giver": "Aria Voss",
      "quest_giver_id": "char_123",
      "quest_category": "main",
      "status": "in-progress",
      "next_action": "Question the ferryman at Blackwake.",
      "resolution": null,
      "objective_count": 3,
      "completed_objective_count": 1,
      "progress_entry_count": 2,
      "related_entity_count": 3,
      "first_session": {
        "id": "sess_001",
        "number": 4,
        "title": "Ashes on the Water",
        "session_date": "2025-02-10T02:30:00Z"
      },
      "last_session": {
        "id": "sess_003",
        "number": 6,
        "title": "The Ferryman's Price",
        "session_date": "2025-02-24T02:30:00Z"
      },
      "created_at": "2025-02-10T03:00:00Z",
      "updated_at": "2025-02-24T04:15:00Z"
    }
  ],
  "total": 1,
  "page": 1,
  "size": 20,
  "pages": 1
}

{
  "detail": "Invalid API key"
}

{
  "detail": "Access denied to this campaign"
}

{
  "id": "quest_123",
  "campaign_id": "camp_abc123",
  "order_index": 2,
  "quest_name": "Recover the Azure Sigil",
  "quest_giver": "Aria Voss",
  "quest_giver_id": "char_123",
  "quest_category": "main",
  "status": "in-progress",
  "success_definition": "Return the sigil to Aria Voss.",
  "failure_conditions": "The sigil is destroyed or delivered to House Merrow.",
  "next_action": "Question the ferryman at Blackwake.",
  "resolution": null,
  "objective_count": 3,
  "completed_objective_count": 1,
  "progress_entry_count": 2,
  "objectives": [
    { "id": "obj_1", "text": "Reach Blackwake alive", "status": "completed", "order": 1 },
    { "id": "obj_2", "text": "Find who bought the sigil", "status": "in-progress", "order": 2 },
    { "id": "obj_3", "text": "Recover the sigil", "status": "pending", "order": 3 }
  ],
  "progress_log": [
    "The party tracked the smugglers to Blackwake.",
    "A ferryman claimed House Merrow paid for a sealed relic case."
  ],
  "progress_log_entries": [
    {
      "id": "prog_1",
      "text": "The party tracked the smugglers to Blackwake.",
      "order": 1,
      "session_id": "sess_002",
      "session_number": 5,
      "session_title": "Salt and Smoke",
      "session_date": "2025-02-17T02:30:00Z"
    }
  ],
  "related_characters": ["Captain Nera", "Dovan Pike — suspect buyer"],
  "related_factions": ["House Merrow"],
  "related_locations": ["Blackwake Docks"],
  "related_items": ["Azure Sigil"],
  "related_entity_refs": [
    {
      "id": "qe_1",
      "entity_type": "character",
      "entity_id": "char_456",
      "entity_name_snapshot": "Captain Nera",
      "label": "Captain Nera",
      "order": 1
    },
    {
      "id": "qe_2",
      "entity_type": "item",
      "entity_id": "item_123",
      "entity_name_snapshot": "Azure Sigil",
      "label": "Azure Sigil",
      "order": 4
    }
  ],
  "first_session": {
    "id": "sess_001",
    "number": 4,
    "title": "Ashes on the Water",
    "session_date": "2025-02-10T02:30:00Z"
  },
  "last_session": {
    "id": "sess_003",
    "number": 6,
    "title": "The Ferryman's Price",
    "session_date": "2025-02-24T02:30:00Z"
  },
  "created_at": "2025-02-10T03:00:00Z",
  "updated_at": "2025-02-24T04:15:00Z"
}

{
  "detail": "Quest not found"
}

{
  "id": "quest_new456",
  "campaign_id": "camp_abc123",
  "order_index": 7,
  "quest_name": "Recover the Azure Sigil",
  "quest_giver": "Aria Voss",
  "quest_giver_id": "char_123",
  "quest_category": "main",
  "status": "in-progress",
  "success_definition": null,
  "failure_conditions": null,
  "next_action": null,
  "resolution": null,
  "objectives": [
    { "id": "obj_new1", "text": "Find who bought the sigil", "status": "in-progress", "order": 1 },
    { "id": "obj_new2", "text": "Recover the sigil", "status": "pending", "order": 2 }
  ],
  "progress_log": ["The party tracked the smugglers to Blackwake."],
  "progress_log_entries": [
    { "id": "prog_new1", "text": "The party tracked the smugglers to Blackwake.", "order": 1, "session_id": null, "session_number": null, "session_title": null, "session_date": null }
  ],
  "related_characters": [],
  "related_factions": [],
  "related_locations": ["Blackwake Docks"],
  "related_items": ["Azure Sigil"],
  "related_entity_refs": [
    { "id": "qe_new1", "entity_type": "item", "entity_id": "item_123", "entity_name_snapshot": "Azure Sigil", "label": "Azure Sigil", "order": 1 },
    { "id": "qe_new2", "entity_type": "location", "entity_id": null, "entity_name_snapshot": "Blackwake Docks", "label": "Blackwake Docks", "order": 2 }
  ],
  "first_session": null,
  "last_session": null,
  "created_at": "2025-03-01T05:00:00Z",
  "updated_at": "2025-03-01T05:00:00Z"
}

{
  "detail": "Quest giver must match an approved character or faction in this campaign"
}

{
  "detail": "Write access denied to this campaign"
}

{
  "id": "quest_123",
  "campaign_id": "camp_abc123",
  "order_index": 2,
  "quest_name": "Recover the Azure Sigil",
  "quest_giver": "Aria Voss",
  "quest_giver_id": "char_123",
  "quest_category": "main",
  "status": "blocked",
  "success_definition": "Return the sigil to Aria Voss.",
  "failure_conditions": "The sigil is destroyed or delivered to House Merrow.",
  "next_action": "Break into House Merrow's archive vault.",
  "resolution": null,
  "objectives": [
    { "id": "obj_1", "text": "Reach Blackwake alive", "status": "completed", "order": 1 },
    { "id": "obj_2", "text": "Find who bought the sigil", "status": "in-progress", "order": 2 },
    { "id": "obj_3", "text": "Recover the sigil", "status": "pending", "order": 3 }
  ],
  "progress_log": [
    "The party tracked the smugglers to Blackwake.",
    "A ferryman claimed House Merrow paid for a sealed relic case."
  ],
  "progress_log_entries": [
    { "id": "prog_1", "text": "The party tracked the smugglers to Blackwake.", "order": 1, "session_id": "sess_002", "session_number": 5, "session_title": "Salt and Smoke", "session_date": "2025-02-17T02:30:00Z" }
  ],
  "related_characters": ["Captain Nera"],
  "related_factions": ["House Merrow", "Blackwake Dock Union"],
  "related_locations": ["Blackwake Docks"],
  "related_items": ["Azure Sigil"],
  "related_entity_refs": [
    { "id": "qe_1", "entity_type": "character", "entity_id": "char_456", "entity_name_snapshot": "Captain Nera", "label": "Captain Nera", "order": 1 },
    { "id": "qe_2", "entity_type": "faction", "entity_id": null, "entity_name_snapshot": "House Merrow", "label": "House Merrow", "order": 2 },
    { "id": "qe_3", "entity_type": "faction", "entity_id": null, "entity_name_snapshot": "Blackwake Dock Union", "label": "Blackwake Dock Union", "order": 3 },
    { "id": "qe_4", "entity_type": "location", "entity_id": null, "entity_name_snapshot": "Blackwake Docks", "label": "Blackwake Docks", "order": 4 },
    { "id": "qe_5", "entity_type": "item", "entity_id": "item_123", "entity_name_snapshot": "Azure Sigil", "label": "Azure Sigil", "order": 5 }
  ],
  "first_session": {
    "id": "sess_001",
    "number": 4,
    "title": "Ashes on the Water",
    "session_date": "2025-02-10T02:30:00Z"
  },
  "last_session": {
    "id": "sess_003",
    "number": 6,
    "title": "The Ferryman's Price",
    "session_date": "2025-02-24T02:30:00Z"
  },
  "created_at": "2025-02-10T03:00:00Z",
  "updated_at": "2025-03-02T01:15:00Z"
}

{
  "detail": "quest_name cannot be empty"
}

{
  "detail": "Quest not found"
}

(no content)

{
  "detail": "Quest not found"
}

{
  "results": [
    {
      "id": "char_123",
      "name": "Thorin Ironforge",
      "type": "PC",
      "image": null
    }
  ],
  "hasMore": false,
  "page": 1,
  "pages": 1,
  "total": 1
}

{
  "data": [
    {
      "id": "journal_123",
      "campaign_id": "camp_abc123",
      "title": "World History",
      "summary": "A high-level overview of the first age...",
      "token_count": 3245,
      "is_public": false,
      "status": "draft",
      "tags": ["history"],
      "folder_id": "folder_789",
      "created_at": "2024-01-15T10:30:00Z",
      "updated_at": "2024-01-16T10:30:00Z"
    }
  ],
  "total": 8,
  "page": 1,
  "size": 20,
  "pages": 1
}

{
  "detail": "campaign_id is required"
}

{
  "detail": "Invalid API key"
}

{
  "id": "journal_123",
  "campaign_id": "camp_abc123",
  "title": "World History",
  "summary": "A high-level overview of the first age...",
  "content": "In the beginning, the gods created the world of Aetheria...",
  "content_rich": { "root": { "type": "root", "version": 1, "children": [] } },
  "tags": ["history"],
  "token_count": 3245,
  "is_public": false,
  "status": "draft",
  "folder_id": "folder_789",
  "permission_level": "manage",
  "created_at": "2024-01-15T10:30:00Z",
  "updated_at": "2024-01-16T10:30:00Z"
}

{
  "detail": "Journal entry not found"
}

{
  "detail": "Insufficient permissions"
}

{
  "success": true,
  "id": "journal_new456"
}

{
  "detail": "This journal entry exceeds the per-entry token limit"
}

{
  "detail": "Write access denied to this world"
}

{
  "detail": "Journal folder not found"
}

{
  "detail": "Content too large; max 2000000 characters"
}

{
  "success": true,
  "id": "journal_123"
}

{
  "detail": "Insufficient permissions"
}

{
  "detail": "Journal entry not found"
}

{
  "detail": "Cannot remove the current owner from this journal entry."
}

{
  "success": true
}

{
  "detail": "Insufficient permissions"
}

{
  "detail": "Journal entry not found"
}

{
  "data": [
    {
      "id": "folder_123",
      "campaign_id": "camp_abc123",
      "parent_id": null,
      "name": "Lore",
      "path": "lore",
      "description": null,
      "position": 0,
      "metadata": null,
      "created_at": "2024-01-15T10:30:00Z",
      "updated_at": "2024-01-16T10:30:00Z"
    }
  ]
}

{
  "detail": "Access denied to this world"
}

{
  "detail": "World not found"
}

{
  "id": "folder_123",
  "campaign_id": "camp_abc123",
  "parent_id": null,
  "name": "Lore",
  "path": "lore",
  "description": null,
  "position": 0,
  "metadata": null,
  "created_at": "2024-01-15T10:30:00Z",
  "updated_at": "2024-01-16T10:30:00Z"
}

{
  "detail": "Access denied to this world"
}

{
  "detail": "World not found"
}

{
  "detail": "Journal folder not found"
}

{
  "success": true,
  "id": "folder_456"
}

{
  "detail": "Invalid parent folder"
}

{
  "detail": "Folder path already exists for this campaign"
}

{
  "detail": "Write access denied to this world"
}

{
  "detail": "World not found"
}

{
  "success": true,
  "id": "folder_456"
}

{
  "detail": "Folder cannot be its own parent"
}

{
  "detail": "Invalid parent folder"
}

{
  "detail": "Folder path already exists for this campaign"
}

{
  "detail": "Write access denied to this world"
}

{
  "detail": "World not found"
}

{
  "detail": "Journal folder not found"
}

{
  "success": true
}

{
  "detail": "Write access denied to this world"
}

{
  "detail": "World not found"
}

{
  "detail": "Journal folder not found"
}

{
  "used": 3,
  "limit": 50,
  "can_access": true,
  "tier": "legend",
  "billing_cycle_start": "2026-07-01T00:00:00Z",
  "billing_cycle_end": "2026-08-01T00:00:00Z"
}

{ "url": "https://pub-....r2.dev/characters/char_123/....png" }

{ "detail": "Image generation limit reached for this billing cycle" }

{
  "object_key": "characters/char_123/abc.png",
  "upload_url": "https://...",
  "public_url": "https://pub-....r2.dev/characters/char_123/abc.png",
  "expires_in_seconds": 900
}

{ "url": "https://pub-....r2.dev/...", "attached": true }

{ "removed": true }