openapi: 3.2.0
info:
  description: Asynchronous media processing for video, audio, and images.
  title: MediaRuntime Job Results API
  version: 1.0.0
servers:
- description: Production
  url: https://mediaruntime.com
tags:
- description: Redeem completed job output bundles.
  name: Job Results
paths:
  /v1/jobs/{job_id}/bundle:
    get:
      description: Validates the job-scoped delivery token and redirects to a short-lived signed URL for the canonical ZIP output bundle.
      operationId: downloadJobBundle
      parameters:
      - description: The ID of the job to download
        in: path
        name: job_id
        required: true
        schema:
          description: The ID of the job to download
          title: Job Id
          type: string
      - description: Delivery token for browser download
        in: query
        name: token
        required: false
        schema:
          default: ''
          description: Delivery token for browser download
          title: Token
          type: string
      responses:
        '307':
          description: Redirect to a short-lived signed URL for the ZIP output bundle.
          headers:
            Location:
              description: Short-lived signed storage URL for the ZIP bundle.
              schema:
                format: uri
                type: string
        '401':
          description: The delivery token is missing or invalid.
        '403':
          description: The delivery token does not authorize this job.
        '404':
          description: The job or its bundle was not found.
        '410':
          description: The delivery token has expired.
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      security: []
      summary: Download a job output bundle
      tags:
      - Job Results
components:
  schemas:
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          title: Detail
          type: array
      title: HTTPValidationError
      type: object
    ValidationError:
      properties:
        ctx:
          title: Context
          type: object
        input:
          title: Input
        loc:
          items:
            anyOf:
            - type: string
            - type: integer
          title: Location
          type: array
        msg:
          title: Message
          type: string
        type:
          title: Error Type
          type: string
      required:
      - loc
      - msg
      - type
      title: ValidationError
      type: object
  securitySchemes:
    ProductionApiKey:
      description: MediaRuntime server-side API key. Keep it in a secret manager and never expose it in browser or mobile code.
      in: header
      name: X-API-Key
      type: apiKey
    SandboxToken:
      description: Ephemeral credential returned by POST /v1/sandbox/session for bounded sandbox jobs only.
      in: header
      name: X-Sandbox-Token
      type: apiKey
externalDocs:
  description: MediaRuntime developer documentation
  url: https://mediaruntime.com/docs