--- title: "Get conversations" method: GET path: "/api/v1/alpha/conversations/{id}" tags: ["alpha"] deprecated: true --- # Get conversations `GET /api/v1/alpha/conversations/{id}` ## Request - Base URL: `https://point11.ai` - URL: `https://point11.ai/api/v1/alpha/conversations/{id}` - Auth: one of: - HTTP bearer - OAuth 2 (authorization code, authorization URL `https://auth.point11.ai/oauth2/authorize`, token URL `https://auth.point11.ai/oauth2/token`) > **Deprecated.** Deprecated: use alpha.conversations.get.v4 (alpha_conversations_get_v4), which reads the conversation and never streams, lists the plan's versions without their bodies, and opens on a shorter first page; follow a running answer with alpha.turn-events.get.v1 (alpha_turn_events_get), whose last event carries what the answer became. Get one Alpha conversation the member may read: its newest page of messages (pass beforeMessageIndex from nextBeforeMessageIndex for older ones), how it is shared with them, and every version of its plan with its body. While its newest answer is still running, a call with Accept: text/event-stream (REST) or an MCP progress token follows that answer's events and ends with this result; with nothing running it returns at once. A reader following again passes the provisional text it already drew (resumeSegment, resumeOffset) and is not sent it again. An API key reads only the conversations it started. Answered in the values it was published with: a question's PowerPoint attachment is left out of its attachments and file parts, and an edit_file call reads as create_file, its label saying it edited. Media-edit evidence calls are omitted; their resulting artifacts stay visible. ## Path parameters - `id` string, uuid, required: Alpha conversation ID ## Query parameters - `beforeMessageIndex` integer: Read the page of messages before this index (the previous nextBeforeMessageIndex) - `resumeSegment` string: Following again: the provisional text this reader already drew, named by its text-start id after `provisional:`; that segment's text before resumeOffset, and every earlier segment, are not sent again - `resumeOffset` integer: How much of resumeSegment's text this reader drew, in UTF-16 units (default 0) ## Headers - `Point11-Organization` string, uuid ## Response `200` Success. With `Accept: text/event-stream`, the live events as server-sent events: one `progress` event per live event, then exactly one `result` (the output) or `error` (`OperationError`). A refusal before the first event is the ordinary JSON error. - AlphaConversationsGetResponse - `conversation` object, required - `id` string, uuid, required - `title` string, required - `createdAt` string, date-time, required - `updatedAt` string, date-time, required - `messages` union[], required - union - object - `id` string, uuid, required - `metadata` AlphaMetadata, required - `brand` object - … - `regenerateTurnId` string, uuid - `responseVersion` AlphaResponseVersion - … - `threadId` string, uuid, required - `turnId` string, uuid, required - `attachments` object[] - … - `effort` 'low' | 'xhigh' | 'max' - `model` string - `analysisDurationMs` integer - `createdAt` string, date-time - `feedback` object - … - `intent` 'presentation' | 'spreadsheet' | 'document' | 'pdf' | 'ads' | 'page' | 'image' - `adBrief` object - … - `viewing` object - … - `useConnectors` true - `connectorContinuation` true - `asker` object - … - `brief` object - … - `connectorCard` AlphaConnectorCard - … - `role` 'user', required - `parts` object[], required - `type` 'file', required - `mediaType` 'text/plain' | 'text/csv' | 'application/json' | 'text/markdown' | 'text/html' | 'application/vnd.openxmlformats-officedocument.wordprocessingml.document' | 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet' | 'image/png' | 'image/jpeg' | 'image/webp' | 'application/pdf', required - `filename` string - `url` string, required: The dashboard's link to the file, for a signed-in browser only; API callers read it with alpha.attachments.download by the attachment id in metadata.attachments - object - `id` string, uuid, required - `metadata` AlphaMetadata, required - `brand` object - … - `regenerateTurnId` string, uuid - `responseVersion` AlphaResponseVersion - … - `threadId` string, uuid, required - `turnId` string, uuid, required - `attachments` object[] - … - `effort` 'low' | 'xhigh' | 'max' - `model` string - `analysisDurationMs` integer - `createdAt` string, date-time - `feedback` object - … - `intent` 'presentation' | 'spreadsheet' | 'document' | 'pdf' | 'ads' | 'page' | 'image' - `adBrief` object - … - `viewing` object - … - `useConnectors` true - `connectorContinuation` true - `asker` object - … - `brief` object - … - `connectorCard` AlphaConnectorCard - … - `role` 'assistant', required - `parts` AlphaPartsItem[], required - union - … - object - `id` string, uuid, required - `metadata` AlphaMetadata, required - `brand` object - … - `regenerateTurnId` string, uuid - `responseVersion` AlphaResponseVersion - … - `threadId` string, uuid, required - `turnId` string, uuid, required - `attachments` object[] - … - `effort` 'low' | 'xhigh' | 'max' - `model` string - `analysisDurationMs` integer - `createdAt` string, date-time - `feedback` object - … - `intent` 'presentation' | 'spreadsheet' | 'document' | 'pdf' | 'ads' | 'page' | 'image' - `adBrief` object - … - `viewing` object - … - `useConnectors` true - `connectorContinuation` true - `asker` object - … - `brief` object - … - `connectorCard` AlphaConnectorCard - … - `role` 'assistant', required - `parts` union[], required - union - … - `nextBeforeMessageIndex` integer, nullable, required - `sharing` AlphaSharing, required - `access` 'author' | 'participant' | 'reader', required - `ownerName` string, required - `project` object, nullable, required - `id` string, uuid, required - `name` string, required - `visibility` 'private' | 'organization', required - `teammateOwned` true: Another member owns the project, and so wrote its instructions - `organizationWide` true: Every member reads it: its project is shared with the organization, or it started where every member works (an Advisor action's chat, a Slack channel thread's) - `startedByApiKey` true - `connectorsNeedOptIn` true: Someone other than this reader asked a question, sent a file or owns the project here, so the reader's connected tools join a question of theirs only when it sets useConnectors - `people` object[]: The members the owner shared this conversation with by name - `userId` string, uuid, required - `name` string, required - `focus` union, required: The case this conversation works with its member: an Advisor action to ship or a Win This Customer project; null for an ordinary chat - object - `kind` 'advisor_action', required - `actionId` string, required - object - `kind` 'win_customer', required - `requestId` string, uuid, required - `plan` AlphaPlan, nullable, required: The plan Alpha keeps in this conversation, as last saved: its steps, who does each, and where each stands; null before Alpha writes one - `conversationId` string, uuid, required - `revision` integer, required - `plan` object, required - `title` string, required - `goal` string, required - `thinking` string, required - `steps` object[], required - `key` string, required - `title` string, required - `why` string, required - `performer` 'alpha' | 'person', required - `minutes` integer, required - `status` 'todo' | 'doing' | 'done' | 'needs_you' | 'skipped', required - `note` string, nullable, required - `planVersions` AlphaItem2[], required: The plan's history, oldest first: one version per answer that wrote it (its last revision, with that answer's turn and when it was saved); the newest is `plan` - `conversationId` string, uuid, required - `revision` integer, required - `plan` object, required - `title` string, required - `goal` string, required - `thinking` string, required - `steps` object[], required - `key` string, required - `title` string, required - `why` string, required - `performer` 'alpha' | 'person', required - `minutes` integer, required - `status` 'todo' | 'doing' | 'done' | 'needs_you' | 'skipped', required - `note` string, nullable, required - `turnId` string, uuid, required - `createdAt` string, date-time, required ## Other responses - `400`: The input, query, or Idempotency-Key is invalid. - `401`: The bearer is missing, expired, or not accepted. - `403`: The credential lacks the operation's scope or role, or the operation needs a different door. - `404`: The resource or organization does not exist for this caller. - `405`: This path takes another HTTP method, named in `Allow`. - `409`: The request conflicts with current state or with prior use of its Idempotency-Key. - `413`: The request, or the answer it asks for, is too large; narrow it. - `429`: The credential's rate budget is spent; retry after `Retry-After` seconds. - `500`: An unexpected server failure; retry later. Only `request_id` identifies it. - `503`: A dependency is temporarily unavailable; retry after `Retry-After` seconds. - `default`: Another status a product answers for its own refusal (for example `415` for an unsupported attachment); branch on `code`. --- [API](https://skmtc.dev/point11/apis/point11-api.md) · [All operations](https://skmtc.dev/point11/apis/point11-api/llms.txt) · [OpenAPI document](https://skmtc.dev/point11/apis/point11-api/revisions/36a84c7aca11?raw)