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

# Get Files

> Get a single file by ID



## OpenAPI

````yaml GET /files/get/{id}
openapi: 3.1.0
info:
  title: duohub Retriever API
  description: >-
    Retrieve assisted or non-assisted memory from a duohub knowledge graph. For
    best performance, use the official `duohub` Python package.
  version: 1.0.0
servers:
  - url: https://api.duohub.ai
security:
  - APIKeyHeader: []
paths:
  /files/get/{id}:
    get:
      tags:
        - Files
      summary: Get File
      description: Get a single file by ID
      operationId: getFile
      parameters:
        - name: id
          in: path
          required: true
          description: ID of the file to retrieve
          schema:
            type: string
      responses:
        '200':
          description: File retrieved successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    enum:
                      - success
                  data:
                    type: object
                    properties:
                      id:
                        type: string
                        description: File unique identifier
                      name:
                        type: string
                        description: Name of the file
                      extension:
                        type: string
                        description: File extension
                      bronzeKey:
                        type: string
                        description: Bronze storage key
                      silverTranscriptKey:
                        type: string
                        description: Silver transcript storage key
                      silverAudioKey:
                        type: string
                        description: Silver audio storage key
                      goldAudioKey:
                        type: string
                        description: Gold audio storage key
                      goldChunkKey:
                        type: string
                        description: Gold chunk storage key
                      goldGraphKey:
                        type: string
                        description: Gold graph storage key
                      aiKey:
                        type: string
                        description: AI key
                      externalURI:
                        type: string
                        description: External URI
                      content:
                        type: string
                        description: File content
                      length:
                        type: number
                        description: Length of the file
                      size:
                        type: number
                        description: Size of the file
                      tokens:
                        type: integer
                        description: Number of tokens
                      numSpeakers:
                        type: integer
                        description: Number of speakers
                      hiddenFilesTotal:
                        type: integer
                        description: Total number of hidden files
                      hiddenFilesProcessed:
                        type: integer
                        description: Number of hidden files processed
                      hiddenFilesCreated:
                        type: integer
                        description: Number of hidden files created
                      hiddenFilesIngested:
                        type: integer
                        description: Number of hidden files ingested
                      jobID:
                        type: string
                        description: Associated job ID
                      userID:
                        type: string
                        description: User ID
                      memoryID:
                        type: string
                        description: Memory ID
                      botID:
                        type: string
                        description: Bot ID
                      source:
                        type: string
                        description: Source of the file
                      category:
                        type: string
                        description: File category
                      fileType:
                        type: string
                        description: Type of file
                      originRegion:
                        type: string
                        description: Origin region
                      createdAt:
                        type: string
                        format: date-time
                        description: Creation timestamp
                      updatedAt:
                        type: string
                        format: date-time
                        description: Last update timestamp
                required:
                  - status
                  - data
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    description: Error message
                  status:
                    type: string
                    enum:
                      - bad_request
                required:
                  - error
                  - status
                examples:
                  no_headers:
                    value:
                      error: No headers provided
                      status: bad_request
                  missing_id:
                    value:
                      error: File ID is required (either in path or body)
                      status: bad_request
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    description: Error message
                  status:
                    type: string
                    enum:
                      - unauthorized
                required:
                  - error
                  - status
                example:
                  error: API key is required
                  status: unauthorized
components:
  securitySchemes:
    APIKeyHeader:
      type: apiKey
      in: header
      name: X-API-Key
      description: 'Your duohub API key. Type: str'

````