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

# list_output_members

> List the objects inside a derived-output folder, each presigned inline. Cost class: **fast**.

A recording's ``frames/`` folder is registered as a single ``derived_file``
output, not one row per frame, so this browses the folder straight from
storage. A leaf output (a single markdown/json file) has no members and
returns an empty page.



## OpenAPI

````yaml /openapi.json get /v1/workspaces/{workspace_id}/files/{file_id}/outputs/{output_id}/members
openapi: 3.1.0
info:
  description: >-
    Document intelligence: parse, split, classify, extract, and ground files, or
    build a searchable workspace. Authenticate with ``X-API-Key``.
  title: NDI Platform API
  version: 0.1.0
servers:
  - url: https://ndi-api.nace.ai
security: []
tags: []
paths:
  /v1/workspaces/{workspace_id}/files/{file_id}/outputs/{output_id}/members:
    get:
      tags:
        - files
      summary: list_output_members
      description: >-
        List the objects inside a derived-output folder, each presigned inline.
        Cost class: **fast**.


        A recording's ``frames/`` folder is registered as a single
        ``derived_file``

        output, not one row per frame, so this browses the folder straight from

        storage. A leaf output (a single markdown/json file) has no members and

        returns an empty page.
      operationId: >-
        list_output_members_v1_workspaces__workspace_id__files__file_id__outputs__output_id__members_get
      parameters:
        - in: path
          name: file_id
          required: true
          schema:
            format: uuid
            title: File Id
            type: string
        - in: path
          name: output_id
          required: true
          schema:
            format: uuid
            title: Output Id
            type: string
        - description: Workspace identifier.
          in: path
          name: workspace_id
          required: true
          schema:
            description: Workspace identifier.
            format: uuid
            title: Workspace Id
            type: string
        - description: Members to skip, for paging a large folder.
          in: query
          name: offset
          required: false
          schema:
            default: 0
            description: Members to skip, for paging a large folder.
            minimum: 0
            title: Offset
            type: integer
        - description: Rows per page.
          in: query
          name: limit
          required: false
          schema:
            default: 50
            description: Rows per page.
            maximum: 200
            minimum: 1
            title: Limit
            type: integer
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ArtifactOutputMembersPage'
          description: Successful Response
        '504':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Gateway Timeout
        default:
          content:
            application/json:
              example:
                error:
                  code: invalid_request
                  detail: null
                  message: >-
                    Request body has extra fields that this operation does not
                    accept.
                  request_id: req-01j9k2n3p4q5r6s7t8v9
                  retryable: false
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: >-
            Typed error envelope used by every 4xx and 5xx. ``error.code``
            distinguishes the failure; HTTP status is a consequence of the code.
      security:
        - APIKeyHeader: []
components:
  schemas:
    ArtifactOutputMembersPage:
      additionalProperties: false
      description: >-
        A page of the objects inside a derived-output folder.


        ``total_count`` is the whole folder; ``members`` is the requested
        window,

        so a large ``frames/`` folder streams into the console a page at a time

        instead of presigning thousands of URLs at once.
      properties:
        download_url_expires_at:
          description: When the presigned URLs stop being valid.
          format: date-time
          title: Download Url Expires At
          type: string
        members:
          items:
            $ref: '#/components/schemas/ArtifactOutputMember'
          title: Members
          type: array
        total_count:
          description: Objects in the folder, across all pages.
          title: Total Count
          type: integer
      required:
        - members
        - total_count
        - download_url_expires_at
      title: ArtifactOutputMembersPage
      type: object
    ErrorEnvelope:
      description: Every non-2xx body on ``/v1``.
      example:
        error:
          code: invalid_request
          detail: null
          message: Request body has extra fields that this operation does not accept.
          request_id: req-01j9k2n3p4q5r6s7t8v9
          retryable: false
      properties:
        error:
          $ref: '#/components/schemas/Error'
      required:
        - error
      title: ErrorEnvelope
      type: object
    ArtifactOutputMember:
      additionalProperties: false
      description: >-
        One object inside a derived-output folder, with short-lived fetch URLs.


        A recording's ``frames/`` output is registered as one folder, not one
        row

        per JPEG (root ``AGENTS.md`` → media lane). This is how a caller browses

        that folder's members without the ledger carrying thousands of rows: the

        objects are listed from storage on demand and presigned inline.
      properties:
        download_url:
          description: Time-limited presigned GET URL that saves the member to disk.
          title: Download Url
          type: string
        file_name:
          description: The member's base name.
          title: File Name
          type: string
        path:
          description: Workspace-relative path of the member object.
          title: Path
          type: string
        preview_url:
          description: Time-limited presigned GET URL that a browser renders inline.
          title: Preview Url
          type: string
        size_bytes:
          description: Object size in bytes.
          title: Size Bytes
          type: integer
      required:
        - path
        - file_name
        - size_bytes
        - download_url
        - preview_url
      title: ArtifactOutputMember
      type: object
    Error:
      description: The error object, per spec 12 §1.8.
      properties:
        code:
          $ref: '#/components/schemas/ErrorCode'
        detail:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          description: Structured payload, when the code carries one.
          title: Detail
        message:
          description: Human- and model-readable; says what to do differently.
          title: Message
          type: string
        request_id:
          description: Per-request correlation id; matches the ``X-Request-Id`` header.
          title: Request Id
          type: string
        retryable:
          description: Whether retrying the identical request could succeed.
          title: Retryable
          type: boolean
      required:
        - code
        - message
        - retryable
        - request_id
      title: Error
      type: object
    ErrorCode:
      description: |-
        Every error the ``/v1`` surface can return.

        Clients must treat this as an **open** enum: a new member is an additive
        change (spec 12 §9), and a client that crashes on an unknown code makes
        every future error a breaking change.
      enum:
        - invalid_request
        - unsupported_file_type
        - file_too_large
        - invalid_schema
        - invalid_sql
        - invalid_path_prefix
        - command_not_permitted
        - batch_too_large
        - domain_validation_failed
        - default_label_required
        - wait_required_for_zero_retention
        - workspace_not_found
        - file_not_found
        - job_not_found
        - upload_not_found
        - node_not_found
        - schema_not_found
        - domain_not_found
        - session_not_found
        - access_label_not_found
        - path_conflict
        - schema_version_conflict
        - access_label_name_taken
        - workspace_name_taken
        - access_label_in_use
        - upload_expired
        - file_not_ingested
        - workspace_deleting
        - workspace_not_deletable
        - ingestion_in_progress
        - job_not_cancellable
        - confirmation_required
        - domain_not_published
        - domain_in_use
        - reserved_domain_slug
        - kg_not_built
        - kg_build_in_progress
        - session_busy
        - range_not_satisfiable
        - result_expired
        - access_denied
        - access_backstop_violation
        - access_mode_not_implemented
        - rate_limited
        - concurrency_limit_reached
        - quota_exceeded
        - corrupt_file
        - zero_byte_file
        - encrypted_file
        - parse_failed
        - ocr_failed
        - conversion_failed
        - sheetless_workbook
        - unplayable_media
        - unclassified_pages
        - job_cancelled
        - job_timeout
        - upstream_unavailable
        - internal_error
        - unauthorized
        - not_implemented
      title: ErrorCode
      type: string
  securitySchemes:
    APIKeyHeader:
      in: header
      name: X-API-Key
      type: apiKey

````