POST
/
use-cases

Headers

authorization
string
required

Your API key for authentication. Use Bearer format.

Body

application/json
name
string

Name of the use case.

transfer_number
string

Fallback phone number to transfer the call to if something breaks.

extract_with_ai
object[]

Parameters to extract with AI.

classification_tags
object[]

Classification tags for the use case.

language
enum<string>
default: en-US

Preferred language for the use case.

Available options:
en-US,
en-GB,
es-MX,
es-ES,
pt-PT,
de-DE,
fr-FR,
pl-PL,
ro-RO,
it-IT
detailed_work_hours
object

Detailed work hours for each day of the week.

work_start
string

Start of the work hours.

work_end
string

End of the work hours.

timezone
string

Timezone of the use case.

generic_after_hours_message
string

Generic message to play if the call is after hours.

enable_detailed_work_hours
boolean

Enable detailed work hours in the UI.

keywords
string[]

Keywords you want the transcriber to know about.

hooks
object[] | null

Webhooks to call when the use case is executed.

params
object

Parameters to pass to the use case.

amd
boolean

Enable automatic machine detection. This is a prerequisite to end calls on machines or for Phone Tree Navigation.

amd_behavior
enum<string>

AI assistant behavior when AMD is enabled. Continue is used for Phone Tree Navigation, Hangup to end the call and Message to leave a message. If amd is set, this field is required.

Available options:
Hangup,
Continue,
Message
amd_messages
object

Record of messages to leave on voicemail if amd_behavior is set to Message. You may use parameters as you do in the prompt for templating. The key is the language of the message and the value is the message.

sample_labels
object[]

Available labels for the samples.

hidden
boolean

Hide the use case from the UI.

evaluation_models
string[]

Models the use case is evaluated on.

max_duration_mins
integer

Specifies the maximum duration in minutes for this use-case. This value is overridden by the maximum duration specified for individual calls. If neither is provided, the default duration is 10 minutes.

recorded_message_inbound
boolean

Play 'This call is being recorded' message for inbound calls.

recorded_message_outbound
boolean

Play 'This call is being recorded' message for outbound calls.

show_original_caller_id
boolean

Show the original caller ID on the call screen.

Response

200 - application/json
id
string
required

ID of the use case.

organization_id
string
required

ID of the organization that owns the use case.

name
string

Name of the use case.

transfer_number
string

Fallback phone number to transfer the call to if something breaks.

extract_with_ai
object[]

Parameters to extract with AI.

classification_tags
object[]

Classification tags for the use case.

language
enum<string>
default: en-US

Preferred language for the use case.

Available options:
en-US,
en-GB,
es-MX,
es-ES,
pt-PT,
de-DE,
fr-FR,
pl-PL,
ro-RO,
it-IT
detailed_work_hours
object

Detailed work hours for each day of the week.

work_start
string

Start of the work hours.

work_end
string

End of the work hours.

timezone
string

Timezone of the use case.

generic_after_hours_message
string

Generic message to play if the call is after hours.

enable_detailed_work_hours
boolean

Enable detailed work hours in the UI.

keywords
string[]

Keywords you want the transcriber to know about.

hooks
object[] | null

Webhooks to call when the use case is executed.

params
object

Parameters to pass to the use case.

amd
boolean

Enable automatic machine detection. This is a prerequisite to end calls on machines or for Phone Tree Navigation.

amd_behavior
enum<string>

AI assistant behavior when AMD is enabled. Continue is used for Phone Tree Navigation, Hangup to end the call and Message to leave a message. If amd is set, this field is required.

Available options:
Hangup,
Continue,
Message
amd_messages
object

Record of messages to leave on voicemail if amd_behavior is set to Message. You may use parameters as you do in the prompt for templating. The key is the language of the message and the value is the message.

sample_labels
object[]

Available labels for the samples.

hidden
boolean

Hide the use case from the UI.

evaluation_models
string[]

Models the use case is evaluated on.

max_duration_mins
integer

Specifies the maximum duration in minutes for this use-case. This value is overridden by the maximum duration specified for individual calls. If neither is provided, the default duration is 10 minutes.

recorded_message_inbound
boolean

Play 'This call is being recorded' message for inbound calls.

recorded_message_outbound
boolean

Play 'This call is being recorded' message for outbound calls.

show_original_caller_id
boolean

Show the original caller ID on the call screen.