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

# Upload a file for Ask Oviond

> A presigned upload for one file to add to a question: an image (PNG, JPG, WebP, GIF; up to 5 MB), a PDF (up to 20 MB), or a CSV / Excel (.xlsx, .xls), Word (.docx) or PowerPoint (.pptx) file (up to 30 MB). PUT the file to `upload_url` with `media_type` as its Content-Type and exactly `size` bytes, then name it by `id` and `name` in the question. Only this user's questions can name it, and nothing links to it.



## OpenAPI

````yaml https://api.oviond.com/openapi.json post /v1/ask-oviond/files
openapi: 3.1.0
info:
  title: Oviond Backend API
  version: 1.0.0
  description: Authentication, account management, billing, and media services for Oviond.
  x-logo:
    url: https://app.oviond.com/img/oviond-full-logo.svg
    altText: Oviond
servers:
  - url: https://api.oviond.com
    description: Production
security:
  - ApiKeyAuth: []
  - BearerAuth: []
paths:
  /v1/ask-oviond/files:
    post:
      tags:
        - Ask Oviond
      summary: Upload a file for Ask Oviond
      description: >-
        A presigned upload for one file to add to a question: an image (PNG,
        JPG, WebP, GIF; up to 5 MB), a PDF (up to 20 MB), or a CSV / Excel
        (.xlsx, .xls), Word (.docx) or PowerPoint (.pptx) file (up to 30 MB).
        PUT the file to `upload_url` with `media_type` as its Content-Type and
        exactly `size` bytes, then name it by `id` and `name` in the question.
        Only this user's questions can name it, and nothing links to it.
      operationId: upload_a_file_for_ask_oviond
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AskOviondFileUpload'
      responses:
        '200':
          description: Where to upload it
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AskOviondFileUploadResponse'
components:
  schemas:
    AskOviondFileUpload:
      type: object
      properties:
        file_name:
          type: string
          minLength: 1
          maxLength: 200
        size:
          type: integer
          exclusiveMinimum: 0
      required:
        - file_name
        - size
      additionalProperties: false
    AskOviondFileUploadResponse:
      type: object
      properties:
        success:
          type: boolean
          enum:
            - true
        data:
          type: object
          properties:
            id:
              type: string
            name:
              type: string
            media_type:
              type: string
            upload_url:
              type: string
          required:
            - id
            - name
            - media_type
            - upload_url
      required:
        - success
        - data
  securitySchemes:
    ApiKeyAuth:
      type: http
      scheme: bearer
      description: >-
        Oviond API key (prefix `oviond_`) sent as a Bearer token — the
        credential for REST/programmatic and headless integrations. Manage keys
        in Settings → API Keys. API keys do NOT authenticate the MCP endpoint
        (/mcp), which uses OAuth 2.1 + PKCE.
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: >-
        Supabase-issued JWT used by the Oviond web app session. External API
        consumers should authenticate with an Oviond API key (ApiKeyAuth)
        instead.

````

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