Skip to main content
POST
/
v1
/
agents
/
update
cURL
curl --request POST \
  --url https://api.fluents.ai/v1/agents/update \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "My Agent",
  "prompt": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "user_id": "550e8400-e29b-41d4-a716-446655440000",
    "label": "My Prompt",
    "description": "This is a description",
    "content": "You are a helpful assistant...",
    "context_endpoint": "https://api.example.com/context",
    "collect_fields": [
      "<string>"
    ],
    "type": "prompt",
    "tags": [
      "tag1",
      "tag2"
    ],
    "prompt_template": {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "user_id": "550e8400-e29b-41d4-a716-446655440000",
      "required_context_keys": [
        "tag1",
        "tag2"
      ],
      "label": "My Prompt"
    }
  },
  "language": "en",
  "actions": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "user_id": "550e8400-e29b-41d4-a716-446655440000",
      "type": "action_transfer_call",
      "label": "Transfer Call",
      "description": "This is a description",
      "config": {},
      "action_trigger": {}
    }
  ],
  "voice": {},
  "initial_message": "Hello, how can I help you today?",
  "webhook": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "user_id": "550e8400-e29b-41d4-a716-446655440000",
    "subscriptions": [
      "event_message",
      "event_action"
    ],
    "url": "https://example.com/webhook",
    "method": "POST",
    "label": "My Webhook",
    "description": "This is a description"
  },
  "interrupt_sensitivity": "low",
  "context_endpoint": "https://api.example.com/context",
  "noise_suppression": true,
  "endpointing_sensitivity": "auto",
  "ivr_navigation_mode": "default",
  "conversation_speed": 0.5,
  "initial_message_delay": 1000,
  "openai_model_name_override": "gpt-4",
  "ask_if_human_present_on_idle": true,
  "run_do_not_call_detection": true,
  "llm_fallback": {},
  "deepgram_keywords": {
    "kansas": "10"
  },
  "idle_time_seconds": 10,
  "llm_temperature": 0.5,
  "enable_recording": true,
  "provider": "openai",
  "model": "gpt-4",
  "label": "My Agent",
  "description": "This is a description",
  "transcriber": {},
  "call_duration_sec": 10,
  "max_idle_check_count": 10,
  "max_aggregate_idle_check_count": 123,
  "idle_after_interaction_seconds": 123,
  "voicemail_message": "<string>",
  "openai_account_connection": {}
}'
{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "user_id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "My Agent",
  "prompt": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "user_id": "550e8400-e29b-41d4-a716-446655440000",
    "label": "My Prompt",
    "description": "This is a description",
    "content": "You are a helpful assistant...",
    "context_endpoint": "https://api.example.com/context",
    "collect_fields": [
      "<string>"
    ],
    "type": "prompt",
    "tags": [
      "tag1",
      "tag2"
    ],
    "prompt_template": {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "user_id": "550e8400-e29b-41d4-a716-446655440000",
      "required_context_keys": [
        "tag1",
        "tag2"
      ],
      "label": "My Prompt"
    }
  },
  "language": "en",
  "actions": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "user_id": "550e8400-e29b-41d4-a716-446655440000",
      "type": "action_transfer_call",
      "label": "Transfer Call",
      "description": "This is a description",
      "config": {},
      "action_trigger": {}
    }
  ],
  "voice": {},
  "initial_message": "Hello, how can I help you today?",
  "webhook": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "user_id": "550e8400-e29b-41d4-a716-446655440000",
    "subscriptions": [
      "event_message",
      "event_action"
    ],
    "url": "https://example.com/webhook",
    "method": "POST",
    "label": "My Webhook",
    "description": "This is a description"
  },
  "interrupt_sensitivity": "low",
  "context_endpoint": "https://api.example.com/context",
  "noise_suppression": true,
  "endpointing_sensitivity": "auto",
  "ivr_navigation_mode": "default",
  "conversation_speed": 0.5,
  "initial_message_delay": 1000,
  "openai_model_name_override": "gpt-4",
  "ask_if_human_present_on_idle": true,
  "openai_account_connection": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "user_id": "550e8400-e29b-41d4-a716-446655440000",
    "label": "My Account Connection",
    "description": "This is a description",
    "type": "account_connection_twilio",
    "credentials": {
      "twilio_account_sid": "AC1234567890",
      "twilio_auth_token": "1234567890"
    },
    "steering_pool": [
      "+1234567890"
    ],
    "account_supports_any_caller_id": false,
    "config": {
      "voicemail_detection": {}
    }
  },
  "run_do_not_call_detection": true,
  "llm_fallback": {},
  "deepgram_keywords": {
    "kansas": "10"
  },
  "idle_time_seconds": 10,
  "llm_temperature": 0.5,
  "enable_recording": true,
  "provider": "openai",
  "model": "gpt-4",
  "label": "My Agent",
  "description": "This is a description",
  "transcriber": {},
  "call_duration_sec": 10,
  "max_idle_check_count": 10,
  "max_aggregate_idle_check_count": 123,
  "idle_after_interaction_seconds": 123,
  "voicemail_message": "<string>"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
id
string
required

Body

application/json
​
prompt
object
required
​
actions
object[]
required
​
voice
object
required
​
name
string
Example:

"My Agent"

​
language
enum<string>
Available options:
en,
es,
de,
hi,
pt,
fr,
nl,
id,
it,
ja,
ko
​
initial_message
string
Example:

"Hello, how can I help you today?"

​
webhook
object
​
interrupt_sensitivity
enum<string>
Available options:
low,
high
​
context_endpoint
string
Example:

"https://api.example.com/context"

​
noise_suppression
boolean
Example:

true

​
endpointing_sensitivity
enum<string>
Available options:
auto,
relaxed,
sensitive
​
ivr_navigation_mode
enum<string>
Available options:
default,
off
​
conversation_speed
number
Example:

0.5

​
initial_message_delay
number
Example:

1000

​
openai_model_name_override
string
Example:

"gpt-4"

​
ask_if_human_present_on_idle
boolean
Example:

true

​
run_do_not_call_detection
boolean
Example:

true

​
llm_fallback
object
​
deepgram_keywords
object
Example:
{ "kansas": "10" }
​
idle_time_seconds
number
Example:

10

​
llm_temperature
number
Example:

0.5

​
enable_recording
boolean
Example:

true

​
provider
string
Example:

"openai"

​
model
string
Example:

"gpt-4"

​
label
string
Example:

"My Agent"

​
description
string
Example:

"This is a description"

​
transcriber
object
​
call_duration_sec
number
Example:

10

​
max_idle_check_count
number
Example:

10

​
max_aggregate_idle_check_count
number
​
idle_after_interaction_seconds
number
​
voicemail_message
string
​
openai_account_connection
object | null

Response

​
id
string
required
Example:

"550e8400-e29b-41d4-a716-446655440000"

​
user_id
string
required
Example:

"550e8400-e29b-41d4-a716-446655440000"

​
prompt
object
required
​
actions
object[]
required
​
voice
object
required
​
name
string
Example:

"My Agent"

​
language
enum<string>
Available options:
en,
es,
de,
hi,
pt,
fr,
nl,
id,
it,
ja,
ko
​
initial_message
string
Example:

"Hello, how can I help you today?"

​
webhook
object
​
interrupt_sensitivity
enum<string>
Available options:
low,
high
​
context_endpoint
string
Example:

"https://api.example.com/context"

​
noise_suppression
boolean
Example:

true

​
endpointing_sensitivity
enum<string>
Available options:
auto,
relaxed,
sensitive
​
ivr_navigation_mode
enum<string>
Available options:
default,
off
​
conversation_speed
number
Example:

0.5

​
initial_message_delay
number
Example:

1000

​
openai_model_name_override
string
Example:

"gpt-4"

​
ask_if_human_present_on_idle
boolean
Example:

true

​
openai_account_connection
object
​
run_do_not_call_detection
boolean
Example:

true

​
llm_fallback
object
​
deepgram_keywords
object
Example:
{ "kansas": "10" }
​
idle_time_seconds
number
Example:

10

​
llm_temperature
number
Example:

0.5

​
enable_recording
boolean
Example:

true

​
provider
string
Example:

"openai"

​
model
string
Example:

"gpt-4"

​
label
string
Example:

"My Agent"

​
description
string
Example:

"This is a description"

​
transcriber
object
​
call_duration_sec
number
Example:

10

​
max_idle_check_count
number
Example:

10

​
max_aggregate_idle_check_count
number
​
idle_after_interaction_seconds
number
​
voicemail_message
string
⌘I