MakeAIVideo
Start trial

API reference

MakeAIVideo Workspace API

2 operations · https://app.makeaivideo.ai/api/v1

When to use the Workspace API

API keys belong to an organization, not a person, and the workspace is the thing they write into. GET /workspace confirms which one a key is acting on, which is worth checking in a script that could be pointed at the wrong account.

Defaults set here apply to videos created afterwards, so settings you would otherwise repeat on every create call can be set once with PATCH /workspace.

Default every new video to vertical
curl -X PATCH https://app.makeaivideo.ai/api/v1/workspace \
  -H "Authorization: Bearer $MAV_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "default_aspect_ratio": "9:16" }'
GET/workspaceread

The workspace this key works in

GET https://app.makeaivideo.ai/api/v1/workspace

Responses

  • 200Workspace
PATCH/workspacewrite

Update workspace defaults

PATCH https://app.makeaivideo.ai/api/v1/workspace

Responses

  • 200Workspace
  • 403Owners and admins onlyErrorEnvelope

Workspace API questions

Which workspace does my API key write into?
GET /workspace returns it. Keys are scoped to an organization rather than a user, so this is the check to run before a script starts creating videos.
Can I set defaults so I do not repeat them on every create call?
Yes. PATCH /workspace updates the defaults that new videos inherit, which keeps repeated fields out of every POST /videos body.

MakeAIVideo API guides

  • Quickstart — the create, poll and download loop end to end.
  • Authentication — what the read, write scope on this page mean.
  • Agents — calling these endpoints from an autonomous agent.

Get an API key

The API and MCP server use the same credits and the same balance as the app, with no separate API plan. Create a key under Settings, Advanced, API keys.

Start 7 day free trialMakeAIVideo plans and pricing

7-day free trial with 350 credits, then plans from $9/mo. Cancel anytime before the trial ends.

← Brand kit APIIdeas API →