API.Video Videos API

openapi: 3.1.0
info:
  title: api.video Videos API
  version: 1.0.0
  description: api.video is a video infrastructure platform offering APIs for video on demand, live streaming, analytics, and AI-powered features. This minimal OpenAPI was generated from the public reference documentation and covers the documented Videos endpoints.
servers:
- url: https://ws.api.video
  description: Production
tags:
- name: Videos
paths:
  /videos:
    get:
      summary: List videos
      operationId: listVideos
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
      tags:
      - Videos
    post:
      summary: Create video
      operationId: createVideo
      requestBody:
        content:
          application/json:
            schema:
              type: object
      responses:
        '201':
          description: Created
          content:
            application/json:
              schema:
                type: object
      tags:
      - Videos
  /videos/upload:
    post:
      summary: Upload video
      operationId: uploadVideo
      requestBody:
        content:
          multipart/form-data:
            schema:
              type: object
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
      tags:
      - Videos
  /videos/thumbnail:
    post:
      summary: Upload thumbnail
      operationId: uploadThumbnail
      requestBody:
        content:
          multipart/form-data:
            schema:
              type: object
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
      tags:
      - Videos
    patch:
      summary: Update thumbnail
      operationId: updateThumbnail
      requestBody:
        content:
          application/json:
            schema:
              type: object
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
      tags:
      - Videos
  /videos/{id}:
    parameters:
    - name: id
      in: path
      required: true
      schema:
        type: string
    get:
      summary: Get video
      operationId: getVideo
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
      tags:
      - Videos
    delete:
      summary: Delete video
      operationId: deleteVideo
      responses:
        '204':
          description: No Content
      tags:
      - Videos
    patch:
      summary: Update video
      operationId: updateVideo
      requestBody:
        content:
          application/json:
            schema:
              type: object
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
      tags:
      - Videos
  /videos/discarded:
    get:
      summary: List discarded videos
      operationId: listDiscardedVideos
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
      tags:
      - Videos
  /videos/discarded/{id}:
    parameters:
    - name: id
      in: path
      required: true
      schema:
        type: string
    get:
      summary: Get discarded video
      operationId: getDiscardedVideo
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
      tags:
      - Videos
    patch:
      summary: Update discarded video
      operationId: updateDiscardedVideo
      requestBody:
        content:
          application/json:
            schema:
              type: object
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
      tags:
      - Videos
  /videos/{id}/status:
    parameters:
    - name: id
      in: path
      required: true
      schema:
        type: string
    get:
      summary: Get video status
      operationId: getVideoStatus
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
      tags:
      - Videos
  /videos/upload-token:
    post:
      summary: Create upload token
      operationId: createUploadToken
      requestBody:
        content:
          application/json:
            schema:
              type: object
      responses:
        '201':
          description: Created
          content:
            application/json:
              schema:
                type: object
      tags:
      - Videos
x-generated-from: https://docs.api.video/reference
x-generated-by: claude-crawl-2026-05-08