---
title: "Cancel the dependents management intent"
method: POST
path: "/dependents_management_intents/{dependents_management_intent_id}/cancel"
tags: ["Dependents Management Intents"]
---

# Cancel the dependents management intent

`POST /dependents_management_intents/{dependents_management_intent_id}/cancel`

## Request

- Base URL: `https://test.api.kota.io`
- URL: `https://test.api.kota.io/dependents_management_intents/{dependents_management_intent_id}/cancel`
- Auth: HTTP bearer

Cancels the `dependents_management_intent` in case an employee decides not to proceed with changes to their dependents. Canceling is only allowed from `action_required` status. If the intent is already `canceled`, the operation succeeds without changes. After canceling, a new dependents management intent can be created from the parent intent.

## Path parameters

- `dependents_management_intent_id` string, required

## Response `204`

No Content

## Other responses

- `400`: Bad Request
- `404`: Not Found

## Changes

- **2026-10-26** `998f7cb004ab`: 1 warning
  - deleted the `header` request parameter `X-Platform-Id`
- **2026-08-07** `7b8b3ed87c96`: 1 info
  - added the new optional `header` request parameter `X-Platform-Id`

[Operation history](https://skmtc.dev/kota/apis/kota-api/changes/dependents_management_intents/:dependents_management_intent_id/cancel/post.md)

---

[API](https://skmtc.dev/kota/apis/kota-api.md) - [All operations](https://skmtc.dev/kota/apis/kota-api/llms.txt) - [OpenAPI document](https://skmtc.dev/kota/apis/kota-api/revisions/998f7cb004ab?raw)