---
title: "The environments surface: list, delete, and start a simulation."
method: GET
path: "/simulate/api/harness-environments/"
tags: ["simulate"]
---

# The environments surface: list, delete, and start a simulation.

`GET /simulate/api/harness-environments/`

## Request

- Base URL: `http://localhost:8000`
- URL: `http://localhost:8000/simulate/api/harness-environments/`
- Auth: one of:
  - API key in header `X-Api-Key`
  - API key in header `X-Secret-Key`

An environment is the job that built it (the world itself lives in object
storage, addressed from the job's metadata), so these endpoints project the
same rows the harness-jobs API serves. They exist separately because the
list needs a row, not a run: the jobs list returns every event, receipt and
stage-output payload for up to a hundred jobs, which is a detail document
repeated a hundred times.

Running and grading a simulation are deliberately not here. ``run`` starts
one and returns 202; progress is read from the job.

## Query parameters

- `page` integer
- `limit` integer

## Response `200`

OK

- HarnessEnvironmentListResponse
  - `count` integer, required
  - `next` string, nullable, required
  - `previous` string, nullable, required
  - `total_pages` integer, required
  - `current_page` integer, required
  - `results` HarnessEnvironment[], required
    - `id` string, uuid, required
    - `name` string, required
    - `description` string, nullable, required
    - `domain` string, nullable, required
    - `source_kind` string, required
    - `agent_type` 'voice' | 'chat', required
    - `status` 'building' | 'running' | 'completed' | 'failed', required
    - `stage` string, required
    - `scenario_count` integer, required
    - `sub_goals_count` integer, nullable, required
    - `tools_count` integer, nullable, required
    - `runs_count` integer, required
    - `last_updated` string, date-time, nullable, required
    - `created_at` string, date-time, required

## 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)