> ## Documentation Index > Fetch the complete documentation index at: https://docs.hq.zone/llms.txt > Use this file to discover all available pages before exploring further. # List conversation artifacts > Lists the delivered artifacts for a single conversation in chronological order. Scoped to the caller's workspace and accessible conversations; workspace admins may pass view=admin to view another member's conversation. Each entry includes the artifact id, name, content type, size, a sensitive flag, creation time, and a download URL. Returns only metadata; the bytes are fetched separately via each artifact's download URL. ## OpenAPI ````yaml GET /v1/api/conversations/{id}/artifacts openapi: 3.1.0 info: title: HQ API description: >- Public HTTP API for HQ. Authenticate with a Personal Access Token (`Authorization: Bearer hq_pat_...`) for server-side integrations, or an OAuth 2.1 authorization-code + PKCE flow for browser apps acting on a user's behalf. Both grant from the same resource:action scope vocabulary; an endpoint's required scope is listed under its `security`. license: name: Apache-2.0 identifier: Apache-2.0 version: 1.0.0 servers: - url: https://api.hq.zone description: HQ API (production) security: [] tags: - name: me description: The signed-in user's own account - name: conversations description: Conversations and their messages - name: documents description: The content-addressed documents library - name: schedules description: Scheduled prompts and recurring tasks - name: agents description: Agents, their skills and integrations - name: memory description: What the assistant remembers (L5 governance) - name: tokens description: Personal Access Token management - name: billing description: Usage and billing - name: notifications description: In-app notification center - name: admin description: Workspace administration - name: integrations description: Workspace integrations (Slack, MCP, skills) - name: onboarding description: New-workspace onboarding wizard - name: auth description: Sign-in, sessions, and OAuth paths: /v1/api/conversations/{id}/artifacts: get: tags: - conversations summary: List conversation artifacts description: >- Lists the delivered artifacts for a single conversation in chronological order. Scoped to the caller's workspace and accessible conversations; workspace admins may pass view=admin to view another member's conversation. Each entry includes the artifact id, name, content type, size, a sensitive flag, creation time, and a download URL. Returns only metadata; the bytes are fetched separately via each artifact's download URL. operationId: list_conversation_artifacts parameters: - name: id in: path description: Conversation id required: true schema: type: string format: uuid - name: view in: query description: |- `?view=admin` opts into "see every conv in tenant", honored only when the caller is `workspace_users.is_admin = true`. Falls back silently to participant view otherwise so a crafted URL from a non-admin doesn't leak the existence of admin mode via a 403. required: false schema: type: - string - 'null' - name: q in: query description: |- Free-text filter. Case-insensitive substring match over the conv title, the agent display name, and the latest-message preview (the three things a row shows). Empty/blank = no filter. required: false schema: type: - string - 'null' - name: page in: query description: 1-based page index. Clamped to >= 1. required: false schema: type: - integer - 'null' format: int64 - name: page_size in: query description: Rows per page. Clamped to 1..=100; defaults to 25. required: false schema: type: - integer - 'null' format: int64 - name: sort in: query description: |- `recent` (default, newest activity first), `oldest`, or `title` (A-Z, untitled convs sink to the end). required: false schema: type: - string - 'null' - name: mode in: query description: |- Which lane: `fast` lists only the no-VM "ask" threads; anything else (default) lists the standard agent threads. The two lanes are surfaced as separate tabs in Studio. required: false schema: type: - string - 'null' - name: channel_kind in: query description: |- Optional channel filter. When set to a known channel kind (e.g. `email`) the list returns ONLY threads of that kind - this backs the admin Email > Threads tab. When unset, the default list EXCLUDES `email` so external-correspondence threads don't bleed into the main Home conversation list (they live under the Email section instead). Unknown values yield an empty set rather than an error. required: false schema: type: - string - 'null' responses: '200': description: Delivered artifacts for the conversation content: application/json: schema: $ref: '#/components/schemas/ConvArtifactsResp' security: - bearer_pat: - conversations:read - oauth2: - conversations:read components: schemas: ConvArtifactsResp: type: object required: - artifacts properties: artifacts: type: array items: $ref: '#/components/schemas/ArtifactLite' ArtifactLite: type: object required: - id - name - content_type - size_bytes - sensitive - created_at - download_url - public_url properties: content_type: type: string created_at: type: string format: date-time delivered_seq: type: - integer - 'null' format: int64 description: >- Per-conversation ordering key (migration 0238): the journal `seq` at which this artifact was delivered. Clients interleave artifacts into the transcript by `seq` (the same key message bubbles carry), so a mid-turn chart lands in the same place live and on reload. `null` for rows published before 0238 - fall back to `created_at` ordering then. download_url: type: string id: type: string format: uuid name: type: string public_url: type: string description: >- Absolute, non-expiring PUBLIC capability URL (no auth). The web uses the auth `download_url` (it has the session); a native client embeds artifacts in a WebView that can't carry auth, so it loads images from this. sensitive: type: boolean size_bytes: type: integer format: int64 securitySchemes: bearer_pat: type: http scheme: bearer bearerFormat: hq_pat description: 'Personal Access Token. Send as `Authorization: Bearer hq_pat_...`.' oauth2: type: oauth2 flows: authorizationCode: authorizationUrl: https://app.hq.zone/v1/oauth/authorize tokenUrl: https://api.hq.zone/v1/oauth/token refreshUrl: https://api.hq.zone/v1/oauth/token scopes: admin: Administer the workspace (users, settings, integrations) agents:read: View the agents in your workspace agents:write: Create and configure agents billing:read: View usage and billing information conversations:read: Read your conversations and their messages conversations:write: Start conversations and send messages on your behalf documents:read: Read your documents library documents:write: Upload and manage documents in your library memory:read: Read what the assistant remembers about you memory:write: Correct or delete what the assistant remembers schedules:read: View your scheduled tasks schedules:write: Create and manage scheduled tasks tables:read: Read your tables and their rows tables:write: Create tables and add, edit, or delete rows ````