Upload Avatar Media

Premium Clone (studio avatar training) — coming soon (501).

The route signature is preserved (multipart ‘video’ file + the gate-1 consent payload) so the OpenAPI client still type-generates and the UI card slot survives, but the body is intentionally deferred: no fal/wavespeed model accepts a self-cloning video and HeyGen Studio twins are Enterprise-direct-API-only (we have no direct HeyGen key). The team-type guard fires first so a non-avatar team still gets the 400, then the 501 is returned BEFORE the file is read.

POST /api/v1/teams/{team_id}/avatar/upload

Upload Avatar Media

cURL

curl --request POST \
  --url https://api.example.com/api/v1/teams/{team_id}/avatar/upload \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form 'video=<string>' \
  --form consent_attestation=true \
  --form subject_is_minor=true

422

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>",
      "input": "<unknown>",
      "ctx": {}
    }
  ]
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

team_id · string<uuid> · required

Body

multipart/form-data

video · string · required

consent_attestation · boolean · required

subject_is_minor · boolean · required

Response

200

application/json

Successful Response