---
title: "Manage agency support using a strict reviewed command."
method: POST
path: "/v1/agency-support"
---

# Manage agency support using a strict reviewed command.

`POST /v1/agency-support`

## Request

- Base URL: `https://www.kaicalls.com/api`
- URL: `https://www.kaicalls.com/api/v1/agency-support`
- Auth: HTTP bearer

IDs are in the body. Runtime refinements, current role, assignment and exact approval/hash/lease guards apply. Enrollment creation and commit require a stable Idempotency-Key. Installation run_scenarios also requires evals:write. Care requires sms:write and exact owner approval; preparation creates a draft, launch explicitly queues it. Provider-unknown outcomes require reconciliation. Configuration, testing, activation, billing and measured outcomes are distinct.

## Headers

- `Idempotency-Key` string

## Request body

- union
  - object
    - `action` 'acknowledge', required
    - `partnerId` string, uuid, required
    - `incidentId` string, uuid, required
  - object
    - `action` 'measure', required
    - `partnerId` string, uuid, required
    - `businessId` string, uuid, required
    - `kind` 'setup' | 'support' | 'fulfillment' | 'provider_cost' | 'retail_receipt', required
    - `minutes` integer
    - `amountCents` integer
    - `note` string, required
  - object
    - `action` 'complete_exercise', required
    - `partnerId` string, uuid, required
    - `installationId` string, uuid, required
    - `exercise` 'verify_launch' | 'handle_failure' | 'report_activity' | 'export_handoff', required

## Response `200`

Recorded command receipt; read back current evidence.

## Other responses

- `202`: Enrollment per-client receipt; inspect waiting and conflict states.
- `400`: Invalid command.
- `403`: Authority or approved owner revision required.
- `409`: State changed or provider reconciliation required.
- `503`: Dependency unavailable; durable operation retained.

---

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