Disconnect an app

Disconnects an app: a CLI's key is deleted, and an MCP client must sign in again.

Only the person signed in to the dashboard can.

Errors

Status	`type`	`code`	When
403	`permission_denied`	`dashboard_session_required`	For any other credential.
404	`not_found`	`connected_app_not_found`	When the app is no longer connected.

It can also fail with the errors every operation shares, such as unauthenticated; see Errors.

More in Connected apps

Something wrong or missing on this page? Tell us by email or on Discord.

On this page

Authorization Path parameters Examples Response body Errors More in Connected apps

Authorization

AuthorizationBearer <token>

A project secret key: vh_sk_... for production, vh_sk_test_... for test. Keep it on your servers.

In: header

Path parameters

connectedAppId*string

The connected app's id, a UUID, as GET /me/connected-apps lists it.

Examples

curl -X DELETE "https://api.voidhash.com/api/v1/me/connected-apps/3f2b8c1e-7d4a-4e9b-a6c5-1d0f8e2b7a94" \  -H "Authorization: Bearer vh_sk_..."

Empty

{  "error": {    "type": "invalid_request",    "code": "string",    "message": "string",    "param": "string"  }}

{  "error": {    "type": "unauthenticated",    "code": "invalid_api_key",    "message": "This secret key is not valid."  }}

{  "error": {    "type": "permission_denied",    "code": "dashboard_session_required",    "message": "Only you, signed in to Voidhash, can accept the Terms of Service; an app or key acting for you cannot."  }}

{  "error": {    "type": "not_found",    "code": "connected_app_not_found",    "message": "You have no connected app 3f2b8c1e-7d4a-4e9b-a6c5-1d0f8e2b7a94; it may have been disconnected.",    "param": "connectedAppId"  }}

{  "error": {    "type": "internal",    "code": "internal_error",    "message": "Something went wrong on our side. Try again, and contact support with the Request-Id header if it keeps failing."  }}

Disconnect an app

Errors

More in Connected apps

Disconnect an app

Errors

More in Connected apps

Authorization

Path parameters

Examples

Response body

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

Disconnect an app

Disconnect an app

204

400application/json

401application/json

403application/json

404application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`