Sign in

v1

latestOpenAPI 3.1.02026-07-265094114.0 KB
Voices

Retrieve all voices

Returns a list of voices available to your workspace, sorted from most recently created

get/v1/tones

Query parameters

qstring
Example:metadata[key]:value

You can use the q parameter to run a query parameter search. Query parameter search supports the following fields: name, metadata, and settings.

Supported operators: AND

The AND operator can be used to combine multiple search criteria.

NOTE: The AND operator supports a maximum of 10 operators

Available field examples:

name: value

metadata[key]:value

settings[appVisibility]:visible

metadata[key1]:value1 AND metadata[key2]:value2

pagenumber

The desired page number of voices

sizenumber

The number of voices per page to return in the response

Response

Retrieve voices

requestIdstring
resourcestring

Example response

[
  {
    "requestId": "bce766ea-a4ef-48e5-9da1-d9602bfecf2d",
    "resource": "tone",
    "data": {
      "name": "It's-a me, Mario!",
      "value": "This voice is energetic, playful, and humorous, characterized by exclamations, wordplay, and a confident, charismatic character, with techniques including catchphrases, direct address, and hyperbole to engage and entertain the audience.",
      "settings": {
        "appVisibility": "visible"
      },
      "id": "ton_2ee766eaa4ef48e59da1d9602bfecf2d",
      "createdAt": "2023-09-21T15:38:00.474Z",
      "updatedAt": "2023-09-21T15:38:00.474Z"
    }
  }
]