Voice Agents

Get a simulation run

The run with its per-scenario results — verdict, rationale, scores, latency, and the full conversation.

GET
/v1/agents/voice/agents/{agent_id}/simulations/{run_id}

Authorization

personalAccessToken
AuthorizationBearer <token>

Personal Access Token of a Dynamiq user — the only credential accepted by the management API (api.*). Prefix dyn_pat_ (legacy uak_ tokens still authenticate). Send as Authorization: Bearer <token>.

In: header

Path Parameters

agent_id*string

Voice agent UUID.

run_id*string

Simulation run UUID.

Response Body

application/json

application/json

application/json

curl -X GET "https://example.com/v1/agents/voice/agents/497f6eca-6276-4993-bfeb-53cbbbba6f08/simulations/497f6eca-6276-4993-bfeb-53cbbbba6f08"
{
  "data": {
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "set_name": "string",
    "mode": "text",
    "status": "pending",
    "job_count": 0,
    "passed_count": 0,
    "failed_count": 0,
    "scores": {
      "accuracy_score": 0,
      "experience_score": 0,
      "scenario_pass_rate": 0
    },
    "error": "string",
    "started_at": "2019-08-24T14:15:22Z",
    "started_by": "03987f6a-4c27-4dc1-b6ab-c7e83bb3e713",
    "ended_at": "2019-08-24T14:15:22Z",
    "scenarios": [
      {
        "label": "string",
        "instructions": "string",
        "agent_expectations": "string",
        "tags": {
          "property1": "string",
          "property2": "string"
        },
        "userdata": {}
      }
    ],
    "summary": {
      "going_well": "string",
      "to_improve": "string",
      "issues": [
        {
          "label": "string",
          "description": "string",
          "suggestion": "string",
          "scenario_label": "string"
        }
      ]
    },
    "jobs": [
      {
        "label": "string",
        "status": "pending",
        "verdict_reason": "string",
        "agent_expectations": "string",
        "error": "string",
        "accuracy_score": 0,
        "experience_score": 0,
        "response_latency_p50_ms": 0,
        "response_latency_p95_ms": 0,
        "transcript": [
          {
            "role": "user",
            "content": "string",
            "tool_name": "string",
            "interrupted": true
          }
        ],
        "started_at": "2019-08-24T14:15:22Z",
        "ended_at": "2019-08-24T14:15:22Z"
      }
    ]
  }
}
{
  "error": {
    "code": "unauthorized",
    "message": "Unauthorized"
  }
}
{
  "error": {
    "code": "not_found",
    "message": "Not Found"
  }
}