---
title: "Removes a lease."
method: DELETE
path: "/leases"
---

# Removes a lease.

`DELETE /leases`

## Request body

- object
  - `principalId` string, required
  - `accountId` string, required

## Response `200`

OK

- Lease — Lease Details
  - `id` string — Lease ID
  - `principalId` string — principalId of the lease to get
  - `accountId` string — accountId of the AWS account
  - `leaseStatus` 'Active' | 'Inactive' — Status of the Lease. "Active": The principal is leased and has access to the account "Inactive": The lease has become inactive, either through expiring, exceeding budget, or by request.
  - `leaseStatusReason` 'LeaseExpired' | 'LeaseOverBudget' | 'LeaseDestroyed' | 'LeaseActive' | 'LeaseRolledBack' — A reason behind the lease status. "LeaseExpired": The lease exceeded its expiration time ("expiresOn") and the associated account was reset and returned to the account pool. "LeaseOverBudget": The lease exceeded its budgeted amount and the associated account was reset and returned to the account pool. "LeaseDestroyed": The lease was adminstratively ended, which can be done via the leases API. "LeaseActive": The lease is active. "LeaseRolledBack": A system error occurred while provisioning the lease. and it was rolled back.
  - `createdOn` number — creation date in epoch seconds
  - `lastModifiedOn` number — date last modified in epoch seconds
  - `budgetAmount` number — budget amount
  - `budgetCurrency` string — budget currency
  - `budgetNotificationEmails` string[] — budget notification emails
  - `leaseStatusModifiedOn` number — date lease status was last modified in epoch seconds
  - `expiresOn` number — date lease should expire in epoch seconds

## Other responses

- `400` — "Failed to Parse Request Body" if the request body is blank or incorrectly formatted. or if there are no account leases found for the specified accountId or if the account specified is not already Active.
- `403` — Failed to authenticate request
- `500` — Server errors if the database cannot be reached.

## Changes

> 12 revisions in range; 3 could not be searched.

- **2019-10-21** `eed5055f8eb6` — 1 breaking, 3 info
  - removed the success response with the status `200`
  - removed the non-success response with the status `400`
  - removed the non-success response with the status `500`
  - added the success response with the status `201`

[Change history](https://skmtc.dev/optum/apis/namespace/changes/leases/delete.md)

---

[API](https://skmtc.dev/optum/apis/namespace.md) · [All operations](https://skmtc.dev/optum/apis/namespace/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/optum/namespace/revisions/11d73002ea62/schema)