MCP is live.Set upAsk the community
OmniDimension
Dashboard
DocumentationAPI referenceSDKsMCP
Simulation

Generate test scenarios

Write test scenarios for an agent from its prompt. Each scenario has a name, the steps the simulated caller follows, and how the agent should respond. Nothing is saved: pass the ones you want to `createSimulation`.

POST/agents//auto-scenarios
Path parameters
agent_idrequired
Body

How many scenarios to write.

curl -X POST 'https://omnidim.io/api/v1/agents/{agent_id}/auto-scenarios' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "number_of_scenarios": 5
}'
Example response
{
  "success": true,
  "scenarios": [
    {
      "name": "Reschedule an appointment",
      "description": "Ask to move tomorrow's appointment to Friday afternoon.",
      "expected_result": "The agent confirms the new slot and repeats the date and time."
    }
  ]
}

Authorization

BearerAuth
headerAuthorizationBearer <token>

Bearer token authentication. Obtain your API key from the OmniDimension dashboard.

Path Parameters

agent_id*integer

The ID of the agent.

Request Body

application/json
number_of_scenarios*integer

How many scenarios to write.

Range1 <= value

Response body

application/json

Response Body

The generated scenarios.

application/json
success?boolean
scenarios?

Apply enhanced prompt

Rewrite the agent's prompt sections from a completed simulation's suggestions. The agent's current sections are replaced, so save a version first if you may want them back. To review a proposed rewrite without applying it, call `enhancePrompt`. The applied text is generated again and can differ slightly from that preview.

Get account balance

Read your organization's wallet: the remaining balance, the minutes it buys at your rates, your plan, your concurrency headroom, and whether auto-recharge will refill it.