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

# Read an uploaded image or metadata file



## OpenAPI

````yaml /openapi.json get /api/metadata/{namespace}/{id}/{filename}
openapi: 3.1.0
info:
  title: RUNNERS Launch API
  version: 1.3.0
  summary: Launch a Solana coin from an agent or bot.
  description: >-
    Upload coin metadata, estimate launch costs, prepare unsigned launch
    transactions, sign locally, submit and confirm. All amounts use integer
    base-unit strings. No website session or integrator API key is required. See
    the Launch a coin guide for the optional authorization messages and the
    launchpad signer.
servers:
  - url: https://runners.family
    description: RUNNERS production API (Solana mainnet)
security: []
tags:
  - name: Launch
    description: >-
      Launch a coin from any HTTP client with an ed25519 keypair: upload the
      image and details, prepare (one transaction when a shared config exists
      for the quote token's price band, otherwise two), sign with the listed
      signers, submit (optionally relayed) and confirm. The launch transactions
      the creator's wallet signs authorize the coin; wallet message signatures
      for the upload and the preparation are optional. See the Launch a coin
      guide.
paths:
  /api/metadata/{namespace}/{id}/{filename}:
    get:
      tags:
        - Launch
      summary: Read an uploaded image or metadata file
      operationId: getMetadataAsset
      parameters:
        - name: namespace
          in: path
          required: true
          schema:
            type: string
        - name: id
          in: path
          required: true
          schema:
            type: string
        - name: filename
          in: path
          required: true
          schema:
            type: string
      responses:
        '200':
          description: The file.
        '404':
          description: Not found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          $ref: '#/components/responses/RateLimited'
components:
  schemas:
    Error:
      type: object
      required:
        - error
      properties:
        code:
          type: string
          description: >-
            Stable machine-readable code. Always present on /api/v1 routes and
            429 responses.
          enum:
            - request_invalid
            - request_too_large
            - origin_forbidden
            - not_found
            - method_not_allowed
            - rate_limited
            - unavailable
        error:
          type: string
          description: Plain-language explanation.
  responses:
    RateLimited:
      description: Too many requests in this route class. Wait `Retry-After` seconds.
      headers:
        Retry-After:
          $ref: '#/components/headers/Retry-After'
        RateLimit-Limit:
          $ref: '#/components/headers/RateLimit-Limit'
        RateLimit-Remaining:
          $ref: '#/components/headers/RateLimit-Remaining'
        RateLimit-Reset:
          $ref: '#/components/headers/RateLimit-Reset'
        RateLimit-Policy:
          $ref: '#/components/headers/RateLimit-Policy'
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            code: rate_limited
            error: Too many requests. Please wait a moment and try again.
  headers:
    Retry-After:
      description: Seconds to wait before retrying.
      schema:
        type: integer
    RateLimit-Limit:
      description: Requests the client may make at once in this route class (bucket size).
      schema:
        type: integer
    RateLimit-Remaining:
      description: Requests available now.
      schema:
        type: integer
    RateLimit-Reset:
      description: Seconds until the bucket is full again.
      schema:
        type: integer
    RateLimit-Policy:
      description: >-
        `<requests>;w=<seconds>;burst=<burst>`: the sustained rate and the
        bucket size.
      schema:
        type: string
      example: 600;w=60;burst=120

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.