Skip to main content
GET
Get topic transfer rules
Returns the topic transfer rules of an agent, the same ones the AI Receptionist shows under Transfer by topic on its Transfers tab.
  • Each rule has a key, the topic that triggers it, the number it transfers to, and what the AI says first (say).
  • rules is empty when the agent has none. An agent has at most 5 rules.
  • status is ready once calls use these rules. Right after a change it is pending, usually for a minute or two. unpublished means the agent’s calls have not been published yet.
MCP keys need numbers:read. See Transfer by topic for how the AI uses each rule.

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.

Response

Topic transfer rules of the agent.

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
Last modified on October 26, 2026