> ## Documentation Index
> Fetch the complete documentation index at: https://docs.firedrill.run/llms.txt
> Use this file to discover all available pages before exploring further.

# List verified retained browser captures

> Requires current run.read. Returns at most 37 exact capture descriptors from the canonical verified report, bound to organization, project, hosted run, canonical report run, bundle digest and expiry. Returns 404 when the report is absent, expired or deleted. An empty list means no captures were retained, not a failed test. Authorization and immutable evidence identity are checked again after artifact reads. Responses are private, no-store.



## OpenAPI

````yaml /api-reference/openapi.json get /v1/projects/{projectId}/browser-runs/{runId}/artifacts
openapi: 3.1.0
info:
  title: Firedrill Control API
  version: 1.0.0
  description: >-
    The control plane for drills, drill runs, and the worlds they run in. Errors
    always carry the canonical envelope; unsafe operations require an
    Idempotency-Key; long work returns an operation resource.
servers:
  - url: https://api.firedrill.run
security:
  - controlCredential: []
tags:
  - name: authentication
    description: Sessions, CLI exchange, credentials, and verification keys.
    x-group: Authentication
  - name: organizations
    description: Organization members, billing, usage, retention, audit, and exports.
    x-group: Organizations
  - name: projects
    description: Project lifecycle, access, grants, and repository bindings.
    x-group: Projects
  - name: builds
    description: Immutable builds, uploads, source drafts, and world definitions.
    x-group: Builds and source
  - name: tools
    description: Project Tool discovery, approval, source, and revocation.
    x-group: Tool library
  - name: worlds
    description: >-
      Managed environments, world sessions, state, time, reset, faults, forks,
      and snapshots.
    x-group: Environments and sessions
  - name: runs
    description: >-
      Hosted runs, comparisons, attachments, reports, evidence bundles, sharing,
      and exports.
    x-group: Runs and evidence
  - name: browser
    description: Managed browser tests, runs, messages, streams, frames, and artifacts.
    x-group: Browser testing
  - name: callbacks
    description: Callback receiver approval, revocation, and signing material.
    x-group: Callbacks
  - name: github-ci
    description: >-
      GitHub installations, repository automation, CI suites, cases, evidence,
      and checks.
    x-group: GitHub and CI
  - name: authoring
    description: Authoring sessions, proposals, turns, and scenario proposals.
    x-group: Cloud authoring
paths:
  /v1/projects/{projectId}/browser-runs/{runId}/artifacts:
    get:
      tags:
        - browser
      summary: List verified retained browser captures
      description: >-
        Requires current run.read. Returns at most 37 exact capture descriptors
        from the canonical verified report, bound to organization, project,
        hosted run, canonical report run, bundle digest and expiry. Returns 404
        when the report is absent, expired or deleted. An empty list means no
        captures were retained, not a failed test. Authorization and immutable
        evidence identity are checked again after artifact reads. Responses are
        private, no-store.
      operationId: browserRuns.listArtifacts
      parameters:
        - name: projectId
          in: path
          required: true
          schema:
            type: string
            pattern: ^prj_[0-9a-z]{12,32}$
        - name: runId
          in: path
          required: true
          schema:
            type: string
            pattern: ^brun_[a-z0-9]{12,64}$
      responses:
        '200':
          description: List verified retained browser captures
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BrowserArtifactList'
        '400':
          description: Canonical error envelope
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
        '401':
          description: Canonical error envelope
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
        '403':
          description: Canonical error envelope
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
        '404':
          description: Canonical error envelope
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
        '409':
          description: Canonical error envelope
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
        '429':
          description: Canonical error envelope
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
        default:
          description: Canonical error envelope
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
components:
  schemas:
    BrowserArtifactList:
      type: object
      properties:
        schemaVersion:
          type: number
          enum:
            - 1
        organizationId:
          type: string
        projectId:
          type: string
        runId:
          type: string
          pattern: ^brun_[a-z0-9]{12,64}$
        reportRunId:
          type: string
          pattern: ^browser_[a-f0-9]{32}$
        bundleSha256:
          type: string
          pattern: ^[0-9a-f]{64}$
        expiresAtMs:
          type: integer
          minimum: -9007199254740991
          maximum: 9007199254740991
        items:
          maxItems: 37
          type: array
          items:
            type: object
            properties:
              path:
                type: string
                minLength: 1
                maxLength: 128
                pattern: ^[A-Za-z0-9][A-Za-z0-9._-]*$
              mediaType:
                type: string
                enum:
                  - image/png
                  - video/webm
                  - application/zip
              bytes:
                type: integer
                minimum: 0
                maximum: 67108864
              sha256:
                type: string
                pattern: ^[0-9a-f]{64}$
            required:
              - path
              - mediaType
              - bytes
              - sha256
            additionalProperties: false
      required:
        - schemaVersion
        - organizationId
        - projectId
        - runId
        - reportRunId
        - bundleSha256
        - expiresAtMs
        - items
      additionalProperties: false
    ErrorEnvelope:
      type: object
      properties:
        code:
          type: string
          pattern: ^(control|world)\.[A-Z][A-Z0-9]*(_[A-Z0-9]+)*$
        message:
          type: string
          minLength: 1
        correlationId:
          type: string
          minLength: 1
        retryable:
          type: boolean
        retryAfterMs:
          type: integer
          exclusiveMinimum: 0
          maximum: 9007199254740991
        operationId:
          type: string
        source:
          type: string
          enum:
            - platform
            - simulated_provider
        issues:
          type: array
          items:
            type: object
            properties:
              path:
                type: string
              code:
                type: string
              message:
                type: string
            required:
              - path
              - code
              - message
            additionalProperties: false
        details:
          type: object
          propertyNames:
            type: string
          additionalProperties: {}
        evidence:
          type: object
          properties:
            sessionId:
              type: string
            runId:
              type: string
            journalSeq:
              type: integer
              minimum: 0
              maximum: 9007199254740991
            buildHash:
              type: string
          additionalProperties: false
      required:
        - code
        - message
        - correlationId
        - retryable
        - source
      additionalProperties: true
  securitySchemes:
    controlCredential:
      type: http
      scheme: bearer
      description: Opaque control credential

````