Skip to main content
PATCH
Update agent behavior config
Merge behavior settings into an agent’s config object without changing prompts, stages, fields, or channel prompts. By default, only the submitted top-level keys change and every other config key remains intact. Use replace: true only when you intentionally need to replace the complete object. Common settings include disabled_channels, first_contact_channel, email_sender_id, and gate_outbound_to_hours. During or after a call, the task can move the conversation to WhatsApp, SMS, iMessage or email. By default (shadow) those messages go out and Nexor only records whether the lead asked for them. Set channel_swap_consent to enforce when the task must message a lead after a call only if the lead asked for it, or accepted the task’s offer to send it. A payment link, booking confirmation, contract, invoice or offer the lead agreed to counts as accepted. Otherwise nothing is sent, and the follow-up after the call does not send it either.
  • shadow or null returns the task to the default.
  • Any other value is rejected with 400 and error: "INVALID_CHANNEL_SWAP_CONSENT". Nothing is saved.
  • Get Agent returns the effective mode as the top-level channel_swap_consent (enforce or shadow). A duplicated task keeps the setting.
  • enforce also stops messages the team may expect, such as “I’ll write to you on WhatsApp” when the lead cannot talk. To stop every move to another channel, disable the channel change tool instead.

Send a hidden copy of the task’s emails (email_bcc)

Set email_bcc to a list of up to 5 email addresses when someone on your team must receive a copy of every email the task sends a lead, for example a supervisor who follows a collections task. The copy is hidden (BCC): the lead does not see those addresses.
  • The copy covers the emails Nexor sends for that task. An email a person writes from the inbox is not copied, and neither is an email to a test lead.
  • The setting belongs to one task (workflow in the API). Save it on each task that needs it.
  • The list you send replaces the saved one. To add an address, send the complete list. null or [] removes the copy.
  • Addresses are saved trimmed, in lowercase and without duplicates. Write each one as a plain address (name@company.com), with no display name.
  • An invalid list is rejected with 400 and error: "INVALID_EMAIL_BCC". Nothing is saved. reason says why: not_a_list, invalid_address or too_many_addresses.
  • There is no visible copy (CC) for the task’s emails.

Authorizations

X-API-Key
string
header
required

API key for authentication. Keys are prefixed with nxr_live_. To work inside a sub-account with a main account key, also send the optional X-Nexor-Sub-Account-Id header.

Path Parameters

id
string<uuid>
required

Agent ID

Body

application/json
config
object
required

Top-level behavior config keys to merge or replace.

replace
boolean
default:false

Replace the complete config object instead of merging.

Response

Config updated

success
boolean
required
Example:

true

workflow_id
string<uuid>
required
config
object
required
Last modified on November 11, 2026