agents

Set a voice line

Set a line of how an AI SDR talks (by sid; golden_set.voice): length, questions, register or sign_off, in your words, up to 160 characters. A line you set is yours: it stays when the voice forms again from the Golden set (voice.pinned names them) and the prompt tells the agent to keep to it. null lets a line go, so the next forming writes it again. The summary is formed, never set. nothing_to_update when no line is named.

Contract:

  • MCP tool update_agent_voice, registry package mcp.unibox/agents, mount unibox.agent-memory.
  • Operation update, response envelope update.
  • Flags: none.
patch/api/agents/{sid}/voice

Request

  • Base URL
    https://beta.getsales.io/unibox/v1
  • Auth
    HTTP bearer and API key in header Team-SID

Path parameters

sidstring required

The agent (ub_ag_…).

Request body

lengthstring nullable

How long its replies run ("2 to 3 sentences"); null lets the line go.

questionsstring nullable

How it asks ("one, at the end"); null lets the line go.

registerstring nullable

The register ("du with agencies, Sie when they wrote Sie"); null lets the line go.

sign_offstring nullable

How it signs off ("VG, Julia"); null lets the line go.

Response

update success envelope.

successtrue required
operation'update' required
updated_fieldsstring[] required
previous_valuesobject required
kept_fieldsstring[]

The fields this write did not change because the person's own value stands on them (stamped person); read the item for what landed.

Changes

No recorded changes to this operation across all 1 revision of this API.