Initiate a new call

curl --request POST \
  --url https://{subdomain}.mihu.ai/api/v1/call \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "agentId": "32d8fc98-be1e-4d32-a12e-146f397fb1cb2",
  "prompt": {
    "overwrite": true,
    "content": "You are Micheal from the support team. You are calling about the issue with the order get order from the customer."
  },
  "participant": {
    "number": "+905435506677",
    "about": "The customer named John Doe.\\n He is a regular customer\\nHis order number is 12345."
  },
  "message": {
    "start": "Hello there!This is a test call.How can help you today?"
  }
}
'

{
  "success": true,
  "message": "Call created successfully",
  "data": {
    "id": "some-call-id",
    "agentId": "32d8fc98-be1e-4d32-a12e-146f397fb1cb2",
    "provider": "twilio",
    "status": "initiated"
  }
}

POST

api

call

Initiate a new call

curl --request POST \
  --url https://{subdomain}.mihu.ai/api/v1/call \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "agentId": "32d8fc98-be1e-4d32-a12e-146f397fb1cb2",
  "prompt": {
    "overwrite": true,
    "content": "You are Micheal from the support team. You are calling about the issue with the order get order from the customer."
  },
  "participant": {
    "number": "+905435506677",
    "about": "The customer named John Doe.\\n He is a regular customer\\nHis order number is 12345."
  },
  "message": {
    "start": "Hello there!This is a test call.How can help you today?"
  }
}
'

{
  "success": true,
  "message": "Call created successfully",
  "data": {
    "id": "some-call-id",
    "agentId": "32d8fc98-be1e-4d32-a12e-146f397fb1cb2",
    "provider": "twilio",
    "status": "initiated"
  }
}

Authorizations

Authorization

string

header

required

Use a Bearer token to access these API endpoints. Example: "Bearer {your-token}"

Body

application/json

agentId

string<uuid>

required

UUID of the Agent. Must exist in the database or the request fails with a 404 error.

Example:

"32d8fc98-be1e-4d32-a12e-146f397fb1cb2"

prompt

object

required

Prompt configuration for the call.

Show child attributes

prompt.overwrite

boolean

required

Whether to overwrite the existing agent prompt with the content below.If false, the agent’s default prompt is used.If false and the prompt has content ,the content will added to the end of the agent’s default prompt.

Example:

true

prompt.content

string

Custom prompt content (used only if overwrite=true). If empty or if overwrite=false, the agent’s default prompt is used.

Example:

"You are Micheal from the support team. You are calling about the issue with the order get order from the customer."

participant

object

required

Information about the call participant.

Show child attributes

participant.number

string

required

Phone number of the participant, in E.164 format (e.g., +1..., +90...).

Example:

"+905435506677"

participant.about

string

Optional info about the participant (e.g., name, role, or notes).

Example:

"The customer named John Doe.\\n He is a regular customer\\nHis order number is 12345."

message

object

Object containing an optional greeting call starts.

Show child attributes

message.start

string

Optional greeting/message to send before the call starts.

Example:

"Hello there!This is a test call.How can help you today?"

Response

Success

success

boolean

Example:

true

message

string

Example:

"Call created successfully"

data

object

Show child attributes

data.id

string

Example:

"some-call-id"

data.agentId

string<uuid>

Example:

"32d8fc98-be1e-4d32-a12e-146f397fb1cb2"

data.provider

string

Example:

"twilio"

data.status

string

Example:

"initiated"

Introduction Get paginated list of calls

⌘I

API Documentation

API Reference

Initiate a new call

Authorizations

Body

Response