Projects

List your Slug conversations, newest first, by the page pane that started them or the subject they are about.

Each conversation's title, the Slug pane that started it (pane, with paneLabel in the writer's words), its projectId and scriptUploadId, messageCount, updatedAt and subject (what it is about: a trailer, a deck, or a pane within its scope). In the app a subject has ONE long-running conversation: its Slug pane (a project's Overview, Cast, Publishing, an episode's Coverage, a trailer…) opens that one, the newest it started with messages, or starts it — never one another pane started — and offers no other; a long one keeps its context through a stored summary of its oldest turns. subject answers that one conversation (or none yet); older conversations about the same subject stay readable in the plain list. pane keeps one pane's conversations, projectId one project's, scriptUploadId one screenplay version's. Read-only. Scope: story:read. Free.

get/conversations

Request

  • Base URL: https://docs.sleeperhit.studio/api/v1
  • URL: https://docs.sleeperhit.studio/api/v1/conversations
  • Auth: HTTP bearer

Query parameters

pane'project-overview' | 'project-cast' | 'project-tours' | 'project-apps' | 'publishing-videos' | 'publishing-show' | 'publishing-season' | 'story-films' | 'video-planner' | 'episode-outline' | 'episode-notes' | 'episode-research' | 'episode-cast' | 'episode-coverage' | 'episode-videos' | 'table-read' | 'scene-direction' | 'voice-explorer' | 'trailer' | 'strategy-pursuits' | 'strategy-pursuit' | 'strategy-opportunities' | 'strategy-opportunity' | 'strategy-contacts' | 'integration-setup'

Only the conversations this Slug pane started. Any other value is refused with validation_failed.

projectIdstring

Only this project's conversations: its project panes' and those about its screenplays.

scriptUploadIdstring

Only those about this screenplay version.

subjectstring

Only the subject's one conversation, the one the app opens for it: trailer:<trailerJobId>, deck:<pitchDeckJobId>, pane:<pane> or pane:<pane>:script|project|card|opportunity:<id> (as each listed conversation's subject names it). An empty list when the subject has none yet. A key that names no subject is refused with validation_failed.

limitinteger

How many, newest first. Default 50, at most 200.

Response

The conversations, newest first.

Changes

No recorded changes to this operation across all 1 revision of this API.