---
title: "Disconnect an application"
method: DELETE
path: "/v1/grants/{grantId}"
---

# Disconnect an application

`DELETE /v1/grants/{grantId}`

## Request

- Base URL: `https://docs.greatwait.dev` (the document declares no server; this is the origin it was published from)
- URL: `https://docs.greatwait.dev/v1/grants/{grantId}`
- Auth: HTTP bearer

Disconnects one application, ending every token that grant ever issued — the access tokens and the refresh token together. The grant stays readable afterwards with the instant and the reason it ended. Only the member who granted it can disconnect it, and a grant belonging to somebody else answers exactly as one that does not exist.

## Path parameters

- `grantId` string, required

## Response `200`

Disconnect an application

- object
  - `grant` object, required
    - `client` object, required
      - `id` string, required
      - `name` string, required
    - `createdAt` string, required
    - `environmentKind` 'test' | 'live', required
    - `id` string, required
    - `lastUsedAt` string
    - `project` string, required
    - `revocationReason` 'authorization-code-replayed' | 'client-revoked' | 'member-revoked' | 'refresh-token-replayed'
    - `revokedAt` string
    - `scopes` string[], required
    - `status` 'active' | 'revoked', required

## Other responses

- `401`: Problem document. Possible codes at this status: authentication_required, credential_expired, credential_revoked.
- `403`: Problem document. Possible codes at this status: scope_missing.
- `404`: Problem document. Possible codes at this status: not_found.
- `429`: Problem document. Possible codes at this status: rate_limited.
- `503`: Problem document. Possible codes at this status: capability_not_configured, service_unavailable.

---

[API](https://skmtc.dev/greatwait/apis/greatwait-v1.md) · [All operations](https://skmtc.dev/greatwait/apis/greatwait-v1/llms.txt) · [OpenAPI document](https://skmtc.dev/greatwait/apis/greatwait-v1/revisions/6855bce23e72?raw)