---
title: "Remove an OAuth app"
method: DELETE
path: "/v1/connect/oauth-apps/{appId}"
tags: ["Connect"]
---

# Remove an OAuth app

`DELETE /v1/connect/oauth-apps/{appId}`

## Request

- Base URL: `https://zernio.com/api`
- URL: `https://zernio.com/api/v1/connect/oauth-apps/{appId}`
- Auth: HTTP bearer

Removes the app. Accounts connected through it can no longer refresh their tokens, so when any are connected the call returns 409 OAUTH_APP_IN_USE with `details.accountCount` unless `confirm=true` is passed. With confirm, those accounts are marked as needing reconnection and each fires `account.disconnected`.

## Query parameters

- `confirm` boolean

## Response `200`

The app was removed.

- object
  - `disconnectedAccounts` integer, required

## Other responses

- `400`: Invalid request
- `401`: Missing or invalid API key. `code` is `missing_credentials` when no Authorization header was sent and `invalid_credentials` when the key is unknown, revoked or expired.
- `403`: The caller cannot change workspace settings (INSUFFICIENT_PERMISSIONS).
- `404`: Resource not found
- `409`: Accounts are still connected through the app (OAUTH_APP_IN_USE); resend with confirm=true.

## Changes

- **2026-10-28** `9f1c5346e670`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/zernio/apis/zernio-api/changes/v1/connect/oauth-apps/:appId/delete.md)

---

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