---
title: "Turn one enablement off for good; it stops on the next event."
method: POST
path: "/v1/enablements/{enablementId}/disable"
tags: ["packages"]
---

# Turn one enablement off for good; it stops on the next event.

`POST /v1/enablements/{enablementId}/disable`

## Request

- Base URL: `https://api.kody.codes`
- URL: `https://api.kody.codes/v1/enablements/{enablementId}/disable`
- Auth: HTTP bearer

Turn one enablement off for good; it stops on the next event. Its enabler or an org Owner may turn it off. Turning it on again creates a new enablement with enablementEnable.

Org permission: `org:read`.

## Path parameters

- `enablementId` string, required: Enablement id.

## Request body

- object

## Response `200`

Success.

- object
  - `enablement` object, required
    - `id` string, required
    - `package_id` string, nullable, required
    - `trigger_kind` 'cron' | 'subscription' | 'webhook', required: cron (a package.json#kody.jobs entry), subscription (a package.json#kody.subscriptions topic, inbound email included), or webhook (a minted package.json#kody.webhooks entry).
    - `trigger_name` string, required: Job name, subscription topic, or webhook name.
    - `enabler_user_id` string, required: The person every run acts as, and who is billed.
    - `state` 'on' | 'paused' | 'off', required: paused: the enabler lost access; events are dropped until access is back, then it resumes by itself.
    - `paused_reason` 'org_access' | 'package_access' | 'credential_access', nullable, required
    - `paused_permission` string, nullable, required
    - `paused_resource` object, nullable, required
      - `type` string, required
      - `id` string, required
    - `origin` 'enabled' | 'migrated', required
    - `enabled_at` string, required
    - `disabled_at` string, nullable, required

## Other responses

- `400`: Error envelope `{ "error": { "code", "message", "details"? } }`.
- `401`: Error envelope `{ "error": { "code", "message", "details"? } }`.
- `403`: Error envelope `{ "error": { "code", "message", "details"? } }`.
- `404`: Error envelope `{ "error": { "code", "message", "details"? } }`.
- `409`: Error envelope `{ "error": { "code", "message", "details"? } }`.
- `413`: Error envelope `{ "error": { "code", "message", "details"? } }`.
- `429`: Too many requests (edge IP/token limit) or an entitlement / plan-cap limit. Wait at least `Retry-After` seconds before retrying.
- `500`: Error envelope `{ "error": { "code", "message", "details"? } }`.
- `503`: Error envelope `{ "error": { "code", "message", "details"? } }`.
- `default`: Error envelope `{ "error": { "code", "message", "details"? } }`.

---

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