---
title: "Delete an Incentive"
method: DELETE
path: "/v1/incentives/{id}"
tags: ["Incentives"]
---

# Delete an Incentive

`DELETE /v1/incentives/{id}`

Delete an incentive.

`one_time` incentives that have the following status **CANNOT** be deleted:
* `processing`
* `paid`


## Scopes

| Category | Read only Scope | Write only Scope (read access implicit) |
|---|---|---|
| Manage expenses (`employment_payments`) | - | Manage incentives (`incentive:write`) |

## Path parameters

- `id` string, required

## Headers

- `Authorization` string, required

## Response `200`

Success

- SuccessResponse — A generic success response returned by operations that don't produce a specific resource (e.g., updates, deletes).
  - `data` object, required
    - `status` string — The result status. Always `"ok"` for successful operations.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Not Found
- `409` — Conflict
- `422` — Unprocessable Entity
- `429` — Too many requests

---

[API](https://skmtc.net/remote-com/apis/remote.md) · [All operations](https://skmtc.net/remote-com/apis/remote/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/remote-com/remote/versions/7e6a0c61ac82/schema)