---
title: "POST /experimental/agent-cases/{id}/control"
method: POST
path: "/experimental/agent-cases/{id}/control"
tags: ["Agent cases"]
---

# POST /experimental/agent-cases/{id}/control

`POST /experimental/agent-cases/{id}/control`

Control an agent case from inside its sandbox. Authenticated by the invocation token, not by a user session.

## Path parameters

- `id` string, uuid, required

## Headers

- `x-agent-case-token` string
- `idempotency-key` string

## Request body

- union
  - object
    - `command` 'submit', required
    - `kind` union, required
      - 'note'
      - 'skill-map'
      - 'weak-points'
      - 'scenarios'
      - 'eval-spec'
      - 'plugin'
      - 'report'
    - `content` unknown, required
  - object
    - `command` 'quote', required
    - `spec` object, required
      - `scenarios` string[], required
      - `arms` object[], required
        - `name` string, required
        - `plugin` string
        - `model` string
      - `runs` integer, required
      - `inputs` string, uuid
  - object
    - `command` 'request_eval', required
    - `spec` object, required
      - `scenarios` string[], required
      - `arms` object[], required
        - `name` string, required
        - `plugin` string
        - `model` string
      - `runs` integer, required
      - `inputs` string, uuid
  - object
    - `command` 'done', required
    - `summary` string, required
  - object
    - `command` 'ask', required
    - `question` string, required
  - object
    - `command` 'status', required
    - `message` string, required
  - object
    - `command` 'context', required

## Response `200`

Default Response

- object
  - `message` string, required — The command result or the reason it was refused.
  - `data` unknown

## Other responses

- `401` — Unauthorized
- `404` — Not Found
- `409` — Conflict
- `500` — Internal Server Error

## Changes

- **2026-10-03** `4809028f6ca2` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/tessl/apis/tessl-api/changes/experimental/agent-cases/:id/control/post.md)

---

[API](https://skmtc.dev/tessl/apis/tessl-api.md) · [All operations](https://skmtc.dev/tessl/apis/tessl-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tessl/apis/tessl-api/revisions/ea9739cd90bc?raw)