Skip to main content
DELETE
/
oauth
/
apps
/
{clientId}
Delete OAuth application
curl --request DELETE \
  --url http://sandbox.mintlify.com/oauth/apps/{clientId} \
  --header 'Authorization: Bearer <token>'
Permanently deletes an OAuth application. Only OWNERS and ADMINS can delete OAuth applications.
This action is PERMANENT and cannot be undone. All tokens associated with this application will be revoked immediately.

​
Permissions

Only OWNERS and ADMINS can delete OAuth applications.

​
Path Parameters

ParameterTypeRequiredDescription
clientIdstringYesOAuth application client ID

​
Example Request

curl -X DELETE http://localhost:3001/api/oauth/apps/app_1234567890abcdef \
  -H "Authorization: Bearer <token>"

​
Response

Returns 204 No Content on success.

​
What Happens

  • OAuth application is permanently deleted
  • All access tokens and refresh tokens are revoked
  • All active sessions using this app will fail
  • This action cannot be undone

​
Common Errors

​
401 Unauthorized

Authentication required.

​
403 Forbidden

Only owners and admins can delete OAuth applications.

​
404 Not Found

OAuth application not found with the provided client ID.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
clientId
string
required

Response

Application deleted successfully. All associated tokens have been revoked.