---
title: "Get Qa Agent"
method: GET
path: "/v2/qa-agents/{agent_id}"
tags: ["qa-agents"]
---

# Get Qa Agent

`GET /v2/qa-agents/{agent_id}`

Get a QA agent by id.

## Path parameters

- `agent_id` string, uuid, required

## Response `200`

Successful Response

- QaAgentResponse
  - `id` string, uuid, required
  - `scenario_id` string, uuid, required
  - `model_id` string, uuid, required
  - `name` string, required
  - `description` string, nullable
  - `max_steps` integer, required
  - `partial_args` object, required
  - `public` boolean
  - `subject_type` 'trace' | 'environment' | 'taskset' | 'task' — Canonical resources a QA agent can analyze.
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `scenario_name` string, nullable
  - `scenario_description` string, nullable
  - `scenario_arguments` ScenarioArgument[]
    - `name` string, required
    - `required` boolean
    - `description` string, nullable
    - `type` string, nullable
    - `default` unknown
    - `inputSchema` object, nullable
  - `environment_id` string, uuid, nullable
  - `environment_name` string, nullable
  - `model_name` string, nullable
  - `provider_icon_url` string, nullable
  - `sdk_agent_type` string, nullable
  - `output_properties` QaAgentOutputProperty[]
    - `name` string, required
    - `type` string, required
    - `description` string, nullable
    - `enum_values` string[], nullable
  - `linked_tasksets` QaAgentLinkedTaskset[]
    - `id` string, uuid, required
    - `name` string, required
    - `task_count` integer
    - `judged_trace_count` integer

## Other responses

- `400` — Invalid or malformed request
- `401` — Missing or invalid credentials
- `403` — Caller may not access this resource
- `404` — Referenced entity does not exist
- `409` — Resource already exists
- `422` — Validation Error

## Changes

- **2026-09-25** `44153c2e35e9` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/hud/apis/hud-platform/changes/v2/qa-agents/:agent_id/get.md)

---

[API](https://skmtc.dev/hud/apis/hud-platform.md) · [All operations](https://skmtc.dev/hud/apis/hud-platform/llms.txt) · [OpenAPI document](https://skmtc.dev/hud/apis/hud-platform/revisions/50a2fbc0a044?raw)