Publish agent

curl --request POST \
  --url https://sandbox.voice.miraiminds.co/v2/agents/{agent_id}/publish \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "if_revision": 1
}
'

import requests

url = "https://sandbox.voice.miraiminds.co/v2/agents/{agent_id}/publish"

payload = { "if_revision": 1 }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const url = 'https://sandbox.voice.miraiminds.co/v2/agents/{agent_id}/publish';
const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({if_revision: 1})
};

fetch(url, options)
  .then(res => res.json())
  .then(json => console.log(json))
  .catch(err => console.error(err));

{
  "revision": 4,
  "draft": false,
  "archived": false,
  "analysis": {
    "enabled": false
  },
  "id": "agt_01K2M4P7QRSTVWXYZ0A1B2C3",
  "object": "agent",
  "name": "सर्विस रिमाइंडर",
  "system_prompt": "आप आशु हैं, मिराई मोटर्स के सर्विस एडवाइज़र. {{name}} जी की {{vehicle}} की सर्विस {{due_date}} को ड्यू है. हिंदी में बात करें, छोटे वाक्य बोलें, और ग्राहक से सर्विस की तारीख कन्फर्म करें.",
  "first_message": "नमस्ते, मैं आशु बोल रहा हूं मिराई मोटर्स से. एक मिनट है आपके पास?",
  "voice": {
    "voice_id": "ashu",
    "language": "hi"
  },
  "language": "hi",
  "max_duration_secs": 300,
  "end_call": {
    "enabled": true,
    "message": "धन्यवाद, आपका दिन शुभ हो.",
    "confirm": true
  },
  "voicemail": {
    "action": "hangup"
  },
  "background_sound": {
    "sound": "off"
  },
  "behavior": {
    "interruptions": "normal",
    "adaptive_interruptions": true
  },
  "secondary_languages": [
    "en"
  ],
  "tools": [],
  "created_at": "2026-08-11T09:14:02Z",
  "updated_at": "2026-08-11T09:31:12Z"
}

POST

agents

{agent_id}

publish

Publish agent

curl --request POST \
  --url https://sandbox.voice.miraiminds.co/v2/agents/{agent_id}/publish \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "if_revision": 1
}
'

import requests

url = "https://sandbox.voice.miraiminds.co/v2/agents/{agent_id}/publish"

payload = { "if_revision": 1 }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const url = 'https://sandbox.voice.miraiminds.co/v2/agents/{agent_id}/publish';
const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({if_revision: 1})
};

fetch(url, options)
  .then(res => res.json())
  .then(json => console.log(json))
  .catch(err => console.error(err));

{
  "revision": 4,
  "draft": false,
  "archived": false,
  "analysis": {
    "enabled": false
  },
  "id": "agt_01K2M4P7QRSTVWXYZ0A1B2C3",
  "object": "agent",
  "name": "सर्विस रिमाइंडर",
  "system_prompt": "आप आशु हैं, मिराई मोटर्स के सर्विस एडवाइज़र. {{name}} जी की {{vehicle}} की सर्विस {{due_date}} को ड्यू है. हिंदी में बात करें, छोटे वाक्य बोलें, और ग्राहक से सर्विस की तारीख कन्फर्म करें.",
  "first_message": "नमस्ते, मैं आशु बोल रहा हूं मिराई मोटर्स से. एक मिनट है आपके पास?",
  "voice": {
    "voice_id": "ashu",
    "language": "hi"
  },
  "language": "hi",
  "max_duration_secs": 300,
  "end_call": {
    "enabled": true,
    "message": "धन्यवाद, आपका दिन शुभ हो.",
    "confirm": true
  },
  "voicemail": {
    "action": "hangup"
  },
  "background_sound": {
    "sound": "off"
  },
  "behavior": {
    "interruptions": "normal",
    "adaptive_interruptions": true
  },
  "secondary_languages": [
    "en"
  ],
  "tools": [],
  "created_at": "2026-08-11T09:14:02Z",
  "updated_at": "2026-08-11T09:31:12Z"
}

Authorizations

Authorization

string

header

required

Your workspace secret key, sk_live_ followed by 32 hex characters. Create one in the console under Developers.

Path Parameters

agent_id

string

required

The agent's id (agt_…).

Body

application/json

if_revision

integer

required

Required range: x >= 1

Response

Published

behavior

object

required

How the agent takes turns with the caller. Always present; agents saved before this block existed read back with the defaults.

Show child attributes

secondary_languages

enum<string>[]

required

Other languages callers may speak. Speech recognition listens for them as well as the primary language. Optional; the primary language is never repeated here. Always returned; [] when there are none.

Maximum array length: 4

Available options:

hi,

en,

gu,

mr,

bn,

ta,

te,

kn,

ml,

pa,

od

analysis

null | object

Replace the whole analysis block. Omit output_schema to remove structured extraction. Requires enabled=true to run.

Show child attributes

archived

boolean

default:false

Archive to block new calls; false restores availability subject to draft validation. Accepted call snapshots remain unchanged.

background_sound

Available options:

off,

office

calls_from

null | object

The phone number this agent's outbound calls ring from when the call or its campaign does not choose one; null when unset (the Mirai shared line).

Show child attributes

created_at

string<date-time>

draft

boolean

default:false

Drafts may have empty prompt or greeting, but cannot run calls.

emit_processed_webhook

boolean

default:true

Send call.processed when this agent has post-call tools, analysis or a flow (a flow agent's event carries the call's flow outcome). Set false to turn the event off.

emit_queued_webhook

boolean

default:false

end_call

object

Show child attributes

first_message

string

Maximum string length: 500

flow

object

Present only on a flow agent.

Show child attributes

string

input_schema

object | null

Replace the entire input declaration. Null removes it and restores legacy string variables.

Show child attributes

language

string

Minimum string length: 1

max_duration_secs

integer

default:300

Required range: 30 <= x <= 1800

name

string

Minimum string length: 1

object

any

revision

integer

system_prompt

string

Maximum string length: 12000

tools

object[]

At most 40 tools: 10 pre_call, 20 on_call, 10 post_call. A PATCH replaces the whole list; null empties it. To edit one tool, use PUT/DELETE /v2/agents/{id}/tools/{name}.

Maximum array length: 40

Show child attributes

updated_at

string<date-time>

voice

object

Show child attributes

voicemail

object

Show child attributes

Get started

Agents

Calls

Flows

Tools and secrets

Campaigns

Do-not-call list

Phone numbers

Phone pools

Telephony

Transcriptions

Speech to text

Text to speech

Wallet

Reference

Publish agent

Authorizations

Path Parameters

Body

Response