Favorite Voice

POST

/api/v1/voices/:voice_id/favorite

POST

/api/v1/voices/:voice_id/favorite

$ curl -X POST https://api.onepin.ai/api/v1/voices/voice_id/favorite \
>      -H "Authorization: Bearer <token>" \
>      -H "Content-Type: application/json" \
>      -d '{}'

1 {
2   "data": {
3     "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
4     "name": "Emma Voice",
5     "provider": "aws_polly",
6     "provider_voice_id": "Emma",
7     "is_active": true,
8     "created_at": "2023-11-20T14:22:00Z",
9     "updated_at": "2024-04-10T10:15:00Z",
10     "description": "A clear and friendly American English female voice, suitable for news and narration.",
11     "gender": "female",
12     "accent": "american",
13     "age": "young",
14     "category": "news",
15     "color": "#4A90E2",
16     "tags": [
17       "news",
18       "clear",
19       "friendly"
20     ],
21     "descriptor": "Bright and engaging news anchor voice",
22     "uses_count": 1245,
23     "user_id": null,
24     "source": "platform",
25     "duration_seconds": 15.5,
26     "sample_url": "https://samples.onepin.ai/voices/3fa85f64-5717-4562-b3fc-2c963f66afa6/sample.mp3?expires=1710000000",
27     "supported_languages": [
28       "en-US"
29     ],
30     "supported_models": [
31       "neural",
32       "standard"
33     ],
34     "is_favorite": true
35   },
36   "meta": {
37     "request_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
38     "timestamp": "2024-04-27T12:00:00Z"
39   }
40 }

Add a voice to the current workspace’s favorites.

Favorites are workspace-scoped, not per-user: all members of the workspace see the same favorited set. Idempotent — favoriting a voice that is already favorited succeeds without error. Returns the voice with is_favorite=true. Requires the caller to have at least editor role in the workspace.

Authentication

AuthorizationBearer

Clerk JWT token

AuthorizationBearer

Onepin live API key (op_live_...). Test and public keys are reserved in Phase 1.

Path parameters

voice_idstringRequiredformat: "uuid"

Headers

X-Workspace-Idstring or nullOptional

Response

Successful Response

dataobject

metaobject

Errors

422

Unprocessable Entity Error