Update incoming calls
Set who answers an agent’s calls during business hours and after hours: AI only, AI first and your team when asked, your team first then the AI after 1 to 6 rings, or your team only. Requires confirm: true.
"confirm": true. MCP keys need numbers:write.
Modes per time slot
in_hours.
Set different modes by hours
- Any slot other than
ai_onlyneedsteam_number, with+and the country code. It cannot be the agent’s own number. - Set
modethe way the dashboard does:ai_humanwithtransfer_toequal toteam_numberwhen a slot isai_first_team_when_asked,forwardwithtransfer_towhen both slots areteam_only, andaiotherwise. human_first_then_aiandteam_onlyneed a number that can ring an outside phone. Otherwise the response is 422call_forwarding_provider_unsupported.
slots, mode applies at all times. off stops incoming calls and keeps the number assigned to the agent.
After saving
The response comes back withstatus: "pending". Calls pick up the change within a minute or two; read back until status is ready. A pending or error status is not active yet.
Responses to these writes include saved_in_agent_draft. It is false when the change was applied to the live agent (every customer API key and MCP key). It is true only when NexorGPT saved the change to the agent’s draft; that change reaches calls when the draft is published.
A 409 group_call_settings_number_in_use means another agent already receives calls on this number. Each number answers calls for one agent: remove it from the other agent first, or use another number.Authorizations
API key for authentication. Keys are prefixed with nxr_live_.
Path Parameters
Agent ID (master_workflow in the API). A malformed ID returns 400 invalid_group_id.
Body
Any other key returns 400 group_call_settings_invalid.
off stops incoming calls and keeps the number assigned. ai: the AI answers. ai_human: the AI answers and transfers to transfer_to on request. forward: calls go to transfer_to without the AI. With slots, use ai_human when a slot is ai_first_team_when_asked, forward when both slots are team_only, and ai otherwise.
off, ai, ai_human, forward The agent's number, from numbers in the GET response.
Must be true.
true Required for ai_human and forward, not allowed for off and ai. When team_number is also sent, it must be the same number.
^\+[1-9]\d{7,14}$Who answers during business hours and after hours. Business hours are the Contactability hours of the task where calls start; with no hours set, every call uses in_hours. ai_only: the AI answers and does not transfer when asked for a person. ai_first_team_when_asked: the AI answers and transfers to team_number when the caller asks for a person. human_first_then_ai: team_number rings first, and the AI answers after rings rings if nobody takes the call. team_only: calls go to team_number without the AI.
Your team's number, with + and the country code. Required when a slot is not ai_only. It cannot be the agent's own number.
^\+[1-9]\d{7,14}$Rings before the AI answers in human_first_then_ai, from 1 to 6. Default 4. Only with slots.
1 <= x <= 6Response
Saved settings. status is pending until calls use them.
Agent ID.
Single incoming-call mode. When slots is set, slots decides who answers each call.
off, ai, ai_human, forward The agent's number that receives the calls.
Destination for ai_human or forward; otherwise null.
^\+[1-9]\d{7,14}$ready when calls already use these settings. pending while the change is being applied, usually a minute or two. Never treat pending or error as active.
ready, pending, error, unconfigured Numbers of the account that this agent can use.
Other numbers whose calls follow these settings.
Who answers during business hours and after hours. Business hours are the Contactability hours of the task where calls start; with no hours set, every call uses in_hours. ai_only: the AI answers and does not transfer when asked for a person. ai_first_team_when_asked: the AI answers and transfers to team_number when the caller asks for a person. human_first_then_ai: team_number rings first, and the AI answers after rings rings if nobody takes the call. team_only: calls go to team_number without the AI. null when incoming calls are off.
Your team's number, shared by both slots.
^\+[1-9]\d{7,14}$Rings before the AI answers in human_first_then_ai. null means the default of 4. Each ring lasts about 6 seconds.
1 <= x <= 6false when the change was applied to the live agent (every customer API key and MCP key). true only when NexorGPT saved the change to the agent's draft; that change reaches calls when the draft is published.