Update topic transfer rules
Replace the topics that make the AI transfer an agent’s calls to a number, up to 5 rules. Requires confirm: true.
"confirm": true. MCP keys need numbers:write.
Replace the rules
- The list replaces every rule the agent had. Send each rule you want to keep.
"rules": []removes them all. keyidentifies the rule: a lowercase letter, then lowercase letters, digits or_, up to 24 characters. Eachkeyappears once.topicis up to 300 characters. Describe it the way a caller would ask about it.numberneeds+and the country code. It cannot be one of the agent’s own numbers, or the response is 400group_transfer_rules_self_transfer.sayis up to 200 characters, in the agent’s language.
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. A 409 group_transfer_rules_busy means another change to this agent’s calls is being saved. Try again shortly.
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.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
Response
Rules saved. status is pending until calls use them.
Agent ID.
Topic transfer rules, in the order the AI considers them. Empty when the agent has none.
5ready when calls already use these rules. pending while the change is being applied, usually a minute or two. error needs attention. unpublished when the agent's calls have not been published yet; the rules apply once they are. Never treat pending or error as active.
ready, pending, error, unpublished false 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.