Voice Agent Testing

Start Test Run

Start Test Run

Requires the OWNER or ADMIN role. The live execution engine is not wired up yet. These endpoints create and transition the run record — queued, running, paused, completed, cancelled, budget_exceeded — but nothing here drives a simulated conversation against the agent. A run created with POST /run stays queued until something else (not yet built) advances it; scenarioResults stays empty and overallScore stays 0.

Rejects with 409 if the agent has no test suite, the suite has no enabled scenarios, or an active run (queued/running/paused) already exists for this agent — only one run can be active per agent at a time.

post/voice/testing/{agentId}/run

Request

  • Base URL: https://api.speakai.co/v1
  • URL: https://api.speakai.co/v1/voice/testing/{agentId}/run
  • Auth: API key in header x-speakai-key and API key in header x-access-token

Path parameters

agentIdstring required

Response

Created

status'success'

Changes

No recorded changes to this operation across all 2 revisions of this API.