> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vouchmark.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Update obligation

> Edit a compliance obligation.

Updates an existing compliance obligation. All fields are optional; only the fields you send are changed. Returns the updated [obligation object](/api-reference/compliance/list-obligations#obligation-object).

## Path parameters

<ParamField path="obligationId" type="string" required>
  The obligation ID.
</ParamField>

## Body

<ParamField body="title" type="string">
  Obligation name.
</ParamField>

<ParamField body="description" type="string">
  Detail text. Pass `null` to clear it.
</ParamField>

<ParamField body="frequency" type="string">
  One of `monthly`, `annual`, `one_off`, `custom`.
</ParamField>

<ParamField body="nextDueDate" type="string">
  Next due date as a `YYYY-MM-DD` date string.
</ParamField>

<ParamField body="notifyLeadDays" type="integer[]">
  Reminder lead times in days before the due date.
</ParamField>

<ParamField body="isActive" type="boolean">
  Whether the obligation is actively tracked.
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X PATCH https://api.vouchmark.com/v1/compliance/obligations/obl_aBcD... \
    -H "Authorization: Bearer $TOKEN" \
    -H "Content-Type: application/json" \
    -d '{
      "title": "VAT filing (FIRS)",
      "nextDueDate": "2026-08-21",
      "notifyLeadDays": [14, 3]
    }'
  ```
</RequestExample>

<ResponseExample>
  ```json theme={null}
  {
    "success": true,
    "data": {
      "id": "obl_aBcD...",
      "companyId": "cmp_aBcD...",
      "category": "vat",
      "title": "VAT filing (FIRS)",
      "description": "Monthly VAT return filed with FIRS by the 21st.",
      "frequency": "monthly",
      "nextDueDate": "2026-08-21",
      "lastCompletedAt": null,
      "isSeeded": true,
      "isActive": true,
      "notifyLeadDays": [14, 3],
      "daysUntilDue": 55,
      "createdAt": "2026-06-01T09:00:00Z",
      "updatedAt": "2026-06-27T12:00:00Z"
    }
  }
  ```
</ResponseExample>