Get Voice | OnePin

{
  "data": {
    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "name": "Emma Voice",
    "provider": "AcmeTTS",
    "provider_voice_id": "emma_us_01",
    "is_active": true,
    "created_at": "2024-01-15T09:30:00Z",
    "updated_at": "2024-04-10T14:45:00Z",
    "description": "A clear and friendly American English female voice suitable for news narration.",
    "gender": "female",
    "accent": "american",
    "age": "young",
    "category": "news",
    "color": "#FF5733",
    "tags": [
      "news",
      "clear",
      "friendly"
    ],
    "descriptor": "Bright and engaging tone",
    "uses_count": 1245,
    "user_id": "d290f1ee-6c54-4b01-90e6-d701748f0851",
    "source": "platform",
    "duration_seconds": 12.5,
    "sample_url": "https://cdn.onepin.ai/samples/emma_us_01.mp3",
    "supported_languages": [
      "en-US",
      "en-GB"
    ],
    "is_favorite": false
  },
  "meta": {
    "request_id": "7b9c9f3e-8a4d-4f3a-9b2e-1a2b3c4d5e6f",
    "timestamp": "2024-04-27T12:00:00Z"
  }
}

Get a voice by ID, scoped to caller workspace + platform voices.

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"

Response

Successful Response

dataobject

metaobject

Errors

422

Unprocessable Entity Error

$	curl https://api.onepin.ai/api/v1/voices/voice_id \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json"

Authentication

Path parameters

Headers

Response

Errors