Get Agent Setup

GET /api/v1/workflow/{workflow_id}/agent-setup — request parameters and responses from the Menace Voice API schema.

1 min read

get/api/v1/workflow/{workflow_id}/agent-setup

Request example

curl --request GET \
  --url https://voice.menaceui.com/api/v1/workflow/{workflow_id}/agent-setup \
  --header 'authorization: <string>' \
  --header 'X-API-Key: <string>'

Response

{
  "setup": {
    "agent_brief": "<string>",
    "tone": "<string>",
    "language": "<string>",
    "voice_provider": "<string>",
    "voice_name": "<string>",
    "behavior_notes": "<string>",
    "workflow_stages": [
      "<string>"
    ],
    "agent_name": "<string>",
    "use_case": "<string>",
    "call_type": "inbound"
  },
  "source": "saved"
}

get/api/v1/workflow/{workflow_id}/agent-setup

See authentication for workspace API access. Public embed and artifact endpoints use their documented session or access tokens.

Path parameters

workflow_idintegerrequired#

Headers

authorizationstring · null#

X-API-Keystring · null#

Responses

application/json

Successful Response

setupobject · nullrequired#

Show child attributes

Any of

agent_briefstringrequired#

Length: 1–8000

tonestringrequired#

Length: 1–100

languagestringrequired#

Length: 1–100

voice_providerstringrequired#

Length: 1–100

voice_namestringrequired#

Length: 1–255

behavior_notesstring · null#

Show child attributes

workflow_stagesstring[]#

Optional template hints; the planner chooses the stages from the brief.

Items: max 8

agent_namestringrequired#

Length: 1–255

use_casestringrequired#

Length: 1–2000

call_typeenum<string>required#

Options:inboundoutbound

sourceenum<string>required#

Options:savedlegacymissing

Get Workflow Preview Agent