---
title: "POST /agentcc/shadow-experiments/"
method: POST
path: "/agentcc/shadow-experiments/"
tags: ["agentcc"]
---

# POST /agentcc/shadow-experiments/

`POST /agentcc/shadow-experiments/`

## Request

- Base URL: `http://localhost:8000`
- URL: `http://localhost:8000/agentcc/shadow-experiments/`
- Auth: one of:
  - API key in header `X-Api-Key`
  - API key in header `X-Secret-Key`

CRUD for shadow experiments with pause/resume/complete lifecycle actions.

## Request body

- AgentccShadowExperiment
  - `id` string, uuid
  - `name` string, required
  - `description` string
  - `source_model` string, required: Production model being tested against
  - `shadow_model` string, required: Shadow model receiving mirrored traffic
  - `shadow_provider` string, required: Provider for the shadow model
  - `sample_rate` number: Fraction of traffic to mirror (0.0–1.0)
  - `status` 'active' | 'paused' | 'completed'
  - `total_comparisons` integer
  - `config` object, nullable: Extra configuration
  - `created_by` string, uuid, nullable
  - `created_at` string, date-time
  - `updated_at` string, date-time

## Response `201`

Created

- AgentccShadowExperiment
  - `id` string, uuid
  - `name` string, required
  - `description` string
  - `source_model` string, required: Production model being tested against
  - `shadow_model` string, required: Shadow model receiving mirrored traffic
  - `shadow_provider` string, required: Provider for the shadow model
  - `sample_rate` number: Fraction of traffic to mirror (0.0–1.0)
  - `status` 'active' | 'paused' | 'completed'
  - `total_comparisons` integer
  - `config` object, nullable: Extra configuration
  - `created_by` string, uuid, nullable
  - `created_at` string, date-time
  - `updated_at` string, date-time

## Other responses

- `default`: Default error response

---

[API](https://skmtc.dev/futureagi/apis/future-agi-management-api.md) · [All operations](https://skmtc.dev/futureagi/apis/future-agi-management-api/llms.txt) · [OpenAPI document](https://skmtc.dev/futureagi/apis/future-agi-management-api/revisions/c8684118e142?raw)