curl --request POST \
  --url https://api.voyager.so/v1/cast/{cast_id}/references \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "file_id": "<string>",
  "expected_version": 2
}
'

import requests

url = "https://api.voyager.so/v1/cast/{cast_id}/references"

payload = {
    "file_id": "<string>",
    "expected_version": 2
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({file_id: '<string>', expected_version: 2})
};

fetch('https://api.voyager.so/v1/cast/{cast_id}/references', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "id": "<string>",
  "slug": "<string>",
  "name": "<string>",
  "kind": "character",
  "style": "photoreal",
  "description": "<string>",
  "version": 123,
  "voice_id": "<string>",
  "references": [
    {
      "file_id": "<string>",
      "role": "hero",
      "note": "<string>",
      "url": "<string>",
      "url_expires_at": "2023-11-07T05:31:56Z"
    }
  ],
  "object": "cast",
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z"
}

{
  "error": {
    "type": "invalid_request",
    "code": "invalid_request",
    "message": "<string>",
    "doc_url": "<string>",
    "request_id": "<string>",
    "retryable": true,
    "retry_after_ms": 123,
    "param": "<string>",
    "details": {}
  }
}

{
  "error": {
    "type": "invalid_request",
    "code": "invalid_request",
    "message": "<string>",
    "doc_url": "<string>",
    "request_id": "<string>",
    "retryable": true,
    "retry_after_ms": 123,
    "param": "<string>",
    "details": {}
  }
}

{
  "error": {
    "type": "invalid_request",
    "code": "invalid_request",
    "message": "<string>",
    "doc_url": "<string>",
    "request_id": "<string>",
    "retryable": true,
    "retry_after_ms": 123,
    "param": "<string>",
    "details": {}
  }
}

{
  "error": {
    "type": "invalid_request",
    "code": "invalid_request",
    "message": "<string>",
    "doc_url": "<string>",
    "request_id": "<string>",
    "retryable": true,
    "retry_after_ms": 123,
    "param": "<string>",
    "details": {}
  }
}

{
  "error": {
    "type": "invalid_request",
    "code": "invalid_request",
    "message": "<string>",
    "doc_url": "<string>",
    "request_id": "<string>",
    "retryable": true,
    "retry_after_ms": 123,
    "param": "<string>",
    "details": {}
  }
}

{
  "error": {
    "type": "invalid_request",
    "code": "invalid_request",
    "message": "<string>",
    "doc_url": "<string>",
    "request_id": "<string>",
    "retryable": true,
    "retry_after_ms": 123,
    "param": "<string>",
    "details": {}
  }
}

{
  "error": {
    "type": "invalid_request",
    "code": "invalid_request",
    "message": "<string>",
    "doc_url": "<string>",
    "request_id": "<string>",
    "retryable": true,
    "retry_after_ms": 123,
    "param": "<string>",
    "details": {}
  }
}