Skip to content

List custom contest prompts

GET
/v1/studios/{studio}/contest-prompts
curl --request GET \
--url https://api.caller9.app/v1/studios/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/contest-prompts \
--header 'Authorization: Bearer <token>'

Lists the studio’s custom contest audio overrides. Slots without an override use the platform default prompt (or text-to-speech).

studio
required
string format: uuid

Studio ID (UUID).

Custom prompts.

Media typeapplication/json
object
prompts
required
Array<object>
object
kind
required
string
Allowed values: caller pre loser
number
required

Caller number for kind=caller; null otherwise.

integer | null
>= 1 <= 109
r2_key
required

Storage key of the custom audio.

string

Example

{
"prompts": [
{
"kind": "caller"
}
]
}

Missing, invalid, expired or revoked API key.

Media typeapplication/json
object
error
required

Human-readable error message.

string
code

Machine-readable code (authentication failures only, e.g. KEY_EXPIRED, RATE_LIMITED).

string

Example generated

{
"error": "example",
"code": "example"
}

Not found, or belongs to another organization.

Media typeapplication/json
object
error
required

Human-readable error message.

string
code

Machine-readable code (authentication failures only, e.g. KEY_EXPIRED, RATE_LIMITED).

string

Example generated

{
"error": "example",
"code": "example"
}

Too many requests for this API key. Retry after Retry-After seconds.

Media typeapplication/json
object
error
required

Human-readable error message.

string
code

Machine-readable code (authentication failures only, e.g. KEY_EXPIRED, RATE_LIMITED).

string

Example generated

{
"error": "example",
"code": "example"
}
Retry-After
integer

Seconds until the rate-limit window resets.