Workspace API

What the workspace endpoints are for

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.

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" }'

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.