Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/vidocu-ai:vidocu-ai-videos-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Vidocu Ai Videos API
version: 1.14.0
contact:
name: Vidocu Support
url: https://vidocu.ai
license:
name: Proprietary
url: https://vidocu.ai/terms
description: 'Operations tagged Videos across 2 of this provider''s published API definitions: support-vidocu-openapi.json, vidocu-ai-openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.vidocu.ai
description: Production
security:
- bearerAuth: []
- oauth2: []
tags:
- name: Videos
description: Create, list, update and delete videos
paths:
/v1/videos/upload:
post:
tags:
- Videos
summary: Upload a video
description: 'Accepts a direct file (multipart), a `videoUrl` to fetch, or `filename` + `contentType` to get a presigned upload URL.
**Scope:** `videos:write`
**Role permission:** `canCreate` (OAuth only — API keys carry full workspace permissions)'
operationId: postV1VideosUpload
requestBody:
required: false
content:
application/json:
schema:
type: object
properties:
filename:
type: string
minLength: 1
contentType:
type: string
pattern: ^video\/
videoUrl:
type: string
format: uri
name:
type: string
videoContext:
type: string
projectId:
type: string
minLength: 1
aiGeneratedAudio:
type: boolean
description: Declare that this video's own audio is already AI-generated (voiced with another tool). Exports and the package manifest then mark it as AI-generated audio (EU AI Act Art. 50(2)). Vidocu's own voiceovers are marked automatically.
additionalProperties: false
responses:
'201':
description: Video created
'400':
description: Validation error
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'401':
description: Invalid or missing credentials
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'403':
description: Missing scope (`insufficient_scope`), insufficient role (`insufficient_role`), or quota exhausted (`limit_exceeded`)
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'429':
description: Rate limit exceeded (60 req/min)
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'500':
description: Server error
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
servers:
- url: https://api.vidocu.ai
description: Production
/v1/videos/from-document:
post:
tags:
- Videos
summary: Create a video from a document
description: 'One video straight from a document (PDF, DOCX, PPTX, Keynote, TXT): read, planned, storyboarded and built into editable slides with narration. Optional pace and AI video (Business and Enterprise). Returns the videoId at once; poll the job.
**Scope:** `videos:write`
**Role permission:** `canCreate` (OAuth only — API keys carry full workspace permissions)'
operationId: postV1VideosFrom-document
requestBody:
required: false
content:
application/json:
schema:
type: object
properties:
fileUrl:
type: string
format: uri
filename:
type: string
minLength: 1
maxLength: 300
instructions:
type: string
maxLength: 5000
language:
type: string
minLength: 2
maxLength: 40
projectId:
type: string
minLength: 1
pace:
type: string
enum:
- snackable
- course
- inDepth
aiVideo:
type: object
properties:
enabled:
type: boolean
stylePresetId:
type: string
minLength: 1
maxLength: 40
required:
- enabled
additionalProperties: false
required:
- fileUrl
- filename
additionalProperties: false
responses:
'202':
description: 'Started: { jobId, videoId }; poll GET /v1/jobs/:id'
'400':
description: Validation error
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'401':
description: Invalid or missing credentials
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'403':
description: Missing scope (`insufficient_scope`), insufficient role (`insufficient_role`), or quota exhausted (`limit_exceeded`)
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'429':
description: Rate limit exceeded (60 req/min)
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'500':
description: Server error
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
servers:
- url: https://api.vidocu.ai
description: Production
/v1/videos:
get:
tags:
- Videos
summary: List videos
description: '**Scope:** `videos:read`'
operationId: getV1Videos
parameters:
- name: page
in: query
required: false
schema:
type: integer
minimum: 1
default: 1
- name: limit
in: query
required: false
schema:
type: integer
minimum: 1
maximum: 100
default: 20
- name: status
in: query
required: false
schema:
type: string
enum:
- draft
- in_progress
- completed
- name: projectId
in: query
required: false
schema:
type: string
minLength: 1
- name: uncategorized
in: query
required: false
schema:
type: boolean
- name: backup
in: query
required: false
schema:
type: string
enum:
- none
- taken
- name: approval
in: query
required: false
schema:
type: string
enum:
- pending
- approved
- rejected
- withdrawn
- name: kb
in: query
required: false
schema:
type: string
enum:
- published
- not_published
- none
- name: languageGroup
in: query
required: false
schema:
type: string
minLength: 1
- name: cursor
in: query
required: false
schema:
type: string
minLength: 1
responses:
'200':
description: Success
'400':
description: Validation error
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'401':
description: Invalid or missing credentials
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'403':
description: Missing scope (`insufficient_scope`) or quota exhausted (`limit_exceeded`)
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'429':
description: Rate limit exceeded (60 req/min)
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'500':
description: Server error
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
servers:
- url: https://api.vidocu.ai
description: Production
/v1/videos/{id}:
get:
tags:
- Videos
summary: Get a video
description: '**Scope:** `videos:read`'
operationId: getV1VideosId
parameters:
- name: id
in: path
required: true
schema:
type: string
responses:
'200':
description: Success
'400':
description: Validation error
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'401':
description: Invalid or missing credentials
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'403':
description: Missing scope (`insufficient_scope`) or quota exhausted (`limit_exceeded`)
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'404':
description: Not found
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'429':
description: Rate limit exceeded (60 req/min)
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'500':
description: Server error
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
patch:
tags:
- Videos
summary: Update a video
description: 'Rename, refile, or adjust generation context. A locked video can still be moved between projects; any other change is refused.
**Scope:** `videos:write`
**Role permission:** `canEdit` (OAuth only — API keys carry full workspace permissions)'
operationId: patchV1VideosId
parameters:
- name: id
in: path
required: true
schema:
type: string
requestBody:
required: false
content:
application/json:
schema:
type: object
properties:
name:
type: string
minLength: 1
maxLength: 200
projectId:
type:
- string
- 'null'
minLength: 1
videoContext:
type: string
maxLength: 5000
companyContext:
type: string
maxLength: 5000
subtitleLanguage:
type: string
minLength: 2
maxLength: 10
aiGeneratedAudio:
type: boolean
description: Declare (true) or withdraw (false) that the video's own audio is AI-generated. Refused on a locked video. Takes effect on the next export.
additionalProperties: false
responses:
'200':
description: Success
'400':
description: Validation error
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'401':
description: Invalid or missing credentials
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'403':
description: Missing scope (`insufficient_scope`), insufficient role (`insufficient_role`), or quota exhausted (`limit_exceeded`)
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'404':
description: Not found
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'423':
description: The video's content is locked and can't be changed
'429':
description: Rate limit exceeded (60 req/min)
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'500':
description: Server error
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
delete:
tags:
- Videos
summary: Delete a video
description: 'Removes the video and its stored files. Locked videos are refused.
**Scope:** `videos:write`
**Role permission:** `canDelete` (OAuth only — API keys carry full workspace permissions)'
operationId: deleteV1VideosId
parameters:
- name: id
in: path
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
properties:
success:
type: boolean
enum:
- true
id:
type: string
deleted:
type: boolean
enum:
- true
required:
- success
- id
- deleted
additionalProperties: false
description: Resource deleted.
'400':
description: Validation error
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'401':
description: Invalid or missing credentials
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'403':
description: Missing scope (`insufficient_scope`), insufficient role (`insufficient_role`), or quota exhausted (`limit_exceeded`)
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'404':
description: Not found
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'423':
description: The video's content is locked and can't be changed
'429':
description: Rate limit exceeded (60 req/min)
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'500':
description: Server error
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
servers:
- url: https://api.vidocu.ai
description: Production
/v1/videos/{id}/download:
get:
tags:
- Videos
summary: Get a file URL
description: 'URL of a stored artifact — exported video, source, voiceover audio, SRT or thumbnail. Fetch the file from `downloadUrl`: for a workspace with private media it is signed and expires at `downloadUrlExpiresAt` (request it again for a fresh one); otherwise it equals `url` and never expires.
**Scope:** `videos:read`'
operationId: getV1VideosIdDownload
parameters:
- name: id
in: path
required: true
schema:
type: string
- name: type
in: query
required: false
schema:
type: string
enum:
- video
- source
- audio
- srt
- vtt
- thumbnail
default: video
responses:
'200':
description: Success
'400':
description: Validation error
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'401':
description: Invalid or missing credentials
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'403':
description: Missing scope (`insufficient_scope`) or quota exhausted (`limit_exceeded`)
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'404':
description: Not found
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'429':
description: Rate limit exceeded (60 req/min)
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'500':
description: Server error
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
servers:
- url: https://api.vidocu.ai
description: Production
components:
schemas:
Error:
type: object
properties:
error:
type: object
properties:
code:
type: string
description: Machine-readable code, e.g. `validation_error`, `insufficient_role`, `locked`
message:
type: string
required:
- code
- message
required:
- error
securitySchemes:
bearerAuth:
type: http
scheme: bearer
description: An API key (`vdo_live_...`) or an OAuth 2.0 access token (`vdo_oat_...`).
oauth2:
type: oauth2
flows:
authorizationCode:
authorizationUrl: https://vidocu.ai/oauth/authorize
tokenUrl: https://api.vidocu.ai/oauth/token
scopes:
videos:read: View videos in the workspace
videos:write: Upload and modify videos
projects:read: View project folders
projects:write: Create, update, and delete project folders
subtitles:read: View subtitles
subtitles:write: Generate and edit subtitles
export:write: Export videos
translate:write: Translate videos
voiceover:write: Generate voiceovers
article:read: View help articles
article:write: Generate help articles
analyze:write: Analyze videos
tools:read: List and view tools
tools:write: Execute tools
jobs:read: View job status
courses:read: View courses and their storyboards
courses:write: Create courses and run planning, storyboarding and generation
studio:read: View Studio projects and templates
studio:write: Create, edit and share Studio projects
modules:read: View training modules, results and qualifications
modules:write: Create, edit and translate training modules; record attempts and sign-offs
remixes:read: View remixes and their analysis
remixes:write: Create remixes and run analysis
recordings:read: View AI Recorder jobs and saved logins
recordings:write: Start recordings and manage saved logins
knowledge_base:read: View the knowledge base, its articles and analytics
knowledge_base:write: Create and edit knowledge base content
brand_kit:read: View Brand Kit settings, skills and glossary
brand_kit:write: Change Brand Kit settings, skills and glossary
usage:read: View usage statistics
voices:read: List available voices
voices:write: Delete cloned voices
avatars:read: List available AI avatars
avatars:write: Create custom AI avatars
webhooks:read: View webhook subscriptions
webhooks:write: Create, update, and delete webhooks
process:write: Use one-shot process endpoint
approvals:read: View approval rounds and requests
approvals:write: Request, decide and withdraw approvals
comments:read: View comments on videos
comments:write: Add and delete comments
locks:write: Lock and unlock videos and modules
x-refined-from:
- support-vidocu-openapi.json
- vidocu-ai-openapi.json