GEgetsales
agent_scenarios

Compose agent scenario

Compose a scenario draft from what the person said: a new scenario of the team's own, or with sid a change to it, the unmentioned kept. Nothing is saved: the draft comes back to edit and save through create_agent_scenario or update_agent_scenario (platform_key names a platform scenario it recognized: edit that one). result.notes says what it still needs. 503 composer_unavailable; 422 compose_invalid (outside the vocabulary); 404 when sid names no scenario.

Contract:

  • MCP tool compose_agent_scenario, registry package mcp.unibox/agent_scenarios, mount unibox.agent.
  • Operation action, response envelope action.
  • Flags: read only.
post/api/agent-scenarios/compose

Request

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

Request body

agent_sidstring

The AI SDR whose scenario it is (ub_ag_…); with a platform key, which agent's version. Left out, the team's default agent.

textstring required

What the person said, as they said it.

sidstring

The scenario the words change; leave it out for a new scenario.

Response

action success envelope.

successtrue required
operation'action' required
actionstring required

kebab-case verb; matches the route segment.

itemunknown required

Changes

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