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

# Upload media to user assets (stored + signed URLs)



## OpenAPI

````yaml /api/pixio-api.json post /uploads
openapi: 3.1.0
info:
  title: Pixio API
  version: 1.0.0
  description: >-
    Generate AI media, manage assets, inspect credits, and run saved workflows.
    Typical flow: GET /models -> GET /params -> POST /uploads -> POST /generate
    -> poll GET /generations/{id}. See GET /guide for the full protocol.
servers:
  - url: https://beta.pixio.myapps.ai/api/v1
security:
  - ApiKey: []
paths:
  /uploads:
    post:
      summary: Upload media to user assets (stored + signed URLs)
      requestBody:
        content:
          multipart/form-data:
            schema:
              type: object
              properties:
                file:
                  type: string
                  format: binary
          application/json:
            schema:
              $ref: '#/components/schemas/ImageRequest'
      responses:
        '201':
          description: >-
            { uploads: [{ sourceUrl, filePath, url, signedUrl,
            signedUrlExpiresAt, fileName, fileSize, contentType, mediaType }] }
        '400':
          description: Invalid media
        '401':
          description: Missing/invalid key
components:
  schemas:
    ImageRequest:
      type: object
      properties:
        url:
          type: string
          format: uri
        urls:
          type: array
          items:
            type: string
            format: uri
      description: >-
        JSON body to mirror one or more remote URLs; or send multipart/form-data
        with file/url fields.
  securitySchemes:
    ApiKey:
      type: http
      scheme: bearer
      description: Pixio API key

````