---
title: "PATCH /orgs/{orgId}/compliance/controls/{controlId}"
method: PATCH
path: "/orgs/{orgId}/compliance/controls/{controlId}"
---

# PATCH /orgs/{orgId}/compliance/controls/{controlId}

`PATCH /orgs/{orgId}/compliance/controls/{controlId}`

## Request

- Base URL: `https://api.useanima.sh/v1`
- URL: `https://api.useanima.sh/v1/orgs/{orgId}/compliance/controls/{controlId}`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

## Path parameters

- `orgId` string, required: Organization identifier
- `controlId` string, required: Compliance control identifier

## Request body

- object: Input for updating a control's status
  - `status` 'NOT_STARTED' | 'IN_PROGRESS' | 'IMPLEMENTED' | 'VERIFIED' | 'FAILED', required: New status for the control
  - `owner` string: Owner to assign
  - `nextReviewAt` string: ISO 8601 next review date

## Response `200`

OK

- object: A compliance control record
  - `id` string, required: Unique control identifier
  - `orgId` string, required: Organization identifier
  - `framework` 'SOC2' | 'GDPR' | 'PCI', required: Compliance framework identifier
  - `controlId` string, required: Control identifier (e.g. CC1.1)
  - `title` string, required: Control title
  - `description` string, required: Control description
  - `category` 'CC1' | 'CC2' | 'CC3' | 'CC4' | 'CC5' | 'CC6' | 'CC7' | 'CC8' | 'CC9' | 'A1' | 'PI1' | 'C1' | 'P1', required: Trust Service Criteria category
  - `status` 'NOT_STARTED' | 'IN_PROGRESS' | 'IMPLEMENTED' | 'VERIFIED' | 'FAILED', required: Current status of the compliance control
  - `owner` string, nullable, required: Owner responsible for this control
  - `lastTestedAt` string, nullable, required: ISO 8601 timestamp of last test
  - `nextReviewAt` string, nullable, required: ISO 8601 timestamp of next review
  - `createdAt` string, required: ISO 8601 creation timestamp
  - `updatedAt` string, required: ISO 8601 last update timestamp

---

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