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

# Manage agency care using a strict reviewed command.

`POST /v1/agency-care`

## Request

- Base URL: `https://www.kaicalls.com/api`
- URL: `https://www.kaicalls.com/api/v1/agency-care`
- 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

- object
  - `action` 'preview_review' | 'prepare_review' | 'launch_review', required
  - `partnerId` string, uuid, required
  - `installationId` string, uuid, required
  - `expectedRevision` string, required
  - `fromNumber` string, required
  - `milestones` object[], required
    - `leadId` string, uuid, required
    - `completedAt` string, date-time, required
    - `evidenceRef` string, required
  - `minimumDays` integer, required
  - `fingerprint` string
  - `campaignId` string, uuid
  - `accepted` true

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