---
title: "Withdraw a consent"
method: POST
path: "/api/cis/v1/consents/{consentId}/withdraw"
tags: ["Consents"]
---

# Withdraw a consent

`POST /api/cis/v1/consents/{consentId}/withdraw`

## Path parameters

- `consentId` string, uuid, required

## Headers

- `x-tenant-id` string, required

## Response `200`

Consent withdrawn

- Consent
  - `id` string, uuid
  - `identityId` string, uuid
  - `scope` string
  - `policyId` string, nullable
  - `version` integer
  - `status` 'GRANTED' | 'WITHDRAWN'
  - `proof` object, nullable
  - `grantedAt` string, date-time
  - `withdrawnAt` string, date-time, nullable

## Other responses

- `404` — Resource not found
- `409` — Consent already withdrawn

---

[API](https://skmtc.net/stalela/apis/stalela-cis-customer-identity-service-api.md) · [All operations](https://skmtc.net/stalela/apis/stalela-cis-customer-identity-service-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/stalela/stalela-cis-customer-identity-service-api/revisions/3065faad0b6b/schema)