---
title: "Update tenant-owned lifecycle state for a customer obligation instance"
method: PATCH
path: "/api/v1/customer-obligation-instances/{customer_obligation_instance_id}"
tags: ["Customer Applicability API"]
---

# Update tenant-owned lifecycle state for a customer obligation instance

`PATCH /api/v1/customer-obligation-instances/{customer_obligation_instance_id}`

## Request

- Base URL: `https://api.esheria.ai`
- URL: `https://api.esheria.ai/api/v1/customer-obligation-instances/{customer_obligation_instance_id}`
- Auth: API key in header `x-api-key`

## Path parameters

- `customer_obligation_instance_id` string, uuid, required

## Headers

- `idempotency-key` string, required

## Request body

- CustomerObligationInstanceUpdateRequest
  - `status` 'candidate' | 'accepted' | 'not_applicable' | 'monitoring' | 'retired', nullable
  - `owner_user_id` string, nullable
  - `owner_label` string, nullable
  - `due_date` string, nullable
  - `priority` 'low' | 'normal' | 'high' | 'urgent', nullable
  - `status_reason` string, nullable
  - `status_updated_by` string, nullable
  - `lifecycle_metadata` object

## Response `200`

Successful Response

- unknown

## Other responses

- `401`: Unauthorized
- `402`: Credits exhausted
- `409`: Conflict
- `422`: Validation error
- `503`: Billing or dependency unavailable

---

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