---
title: "Start Red Team Evaluation"
method: POST
path: "/evaluations/v1-beta/red-team"
tags: ["Red Team Evaluations"]
---

# Start Red Team Evaluation

`POST /evaluations/v1-beta/red-team`

Start a new red team client workflow.
Auto-triggers planning phase. Client should then poll /next-action.

## Request body

- ClientRedTeamBody — Request to start a client-driven red team workflow.
  - `name` string, required — Name for this evaluation
  - `target_model` string, required — Target model identifier
  - `objective_ids` string[] — Objective IDs to evaluate
  - `execution_strategy_type` string — Execution strategy type
  - `n_random_techniques` integer — Number of random techniques to use
  - `max_parallel_techniques` integer — Maximum parallel techniques
  - `max_turns` integer — Maximum conversation turns
  - `attacker_max_generation_attempts` integer — Maximum generation attempts for attacker
  - `refusal_judge_model` string — Model for refusal judging
  - `objective_judge_model` string — Model for objective judging
  - `evaluation_report_model` string — Model for evaluation report
  - `attacker_model` string — Model for attacker
  - `hl_project_id` string — HiddenLayer project ID
  - `prompt_set_id` string — Prompt set ID for static prompt evaluation
  - `sessions_per_technique` integer — Number of sessions per technique
  - `target_system_prompt` string — System prompt for the target

## Response `201`

Workflow started successfully

- StartWorkflowResponse — Response from starting a workflow.
  - `workflow_id` string, required — Workflow identifier
  - `run_id` string, required — Run identifier

## Other responses

- `400` — The request failed due to a client error, with one or more of the following possible causes: 1. The request required a tenant_id field, which was missing. 2. The request was malformed syntactically or semantically.
- `422` — Validation Error

## Changes

- **2026-01-26** `87680c24e4b3` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/hiddenlayerai/apis/hiddenlayer-audit-api/changes/evaluations/v1-beta/red-team/post.md)

---

[API](https://skmtc.dev/hiddenlayerai/apis/hiddenlayer-audit-api.md) · [All operations](https://skmtc.dev/hiddenlayerai/apis/hiddenlayer-audit-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/hiddenlayerai/hiddenlayer-audit-api/revisions/45f22ddfb53a/schema)