Skip to main content
PUT
Update topic transfer rules
Read the current rules with Get topic transfer rules first, and send the full list back with "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.
  • key identifies the rule: a lowercase letter, then lowercase letters, digits or _, up to 24 characters. Each key appears once.
  • topic is up to 300 characters. Describe it the way a caller would ask about it.
  • number needs + and the country code. It cannot be one of the agent’s own numbers, or the response is 400 group_transfer_rules_self_transfer.
  • say is up to 200 characters, in the agent’s language.
Rules apply whenever the AI is on the call, during business hours and after hours, and to every task of the agent.

After saving

The response comes back with status: "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

X-API-Key
string
header
required

API key for authentication. Keys are prefixed with nxr_live_.

Path Parameters

id
string<uuid>
required

Agent ID (master_workflow in the API). A malformed ID returns 400 invalid_group_id.

Body

application/json
rules
object[]
required

The full list of rules. Keys must be unique.

Maximum array length: 5
confirm
enum<boolean>
required

Must be true. Send it only after the account owner approves this exact list.

Available options:
true

Response

Rules saved. status is pending until calls use them.

agent_group_id
string<uuid>
required

Agent ID.

rules
object[]
required

Topic transfer rules, in the order the AI considers them. Empty when the agent has none.

Maximum array length: 5
status
enum<string>
required

ready 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.

Available options:
ready,
pending,
error,
unpublished
saved_in_agent_draft
boolean
required

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.

Last modified on October 26, 2026