---
title: "Revoke Oauth"
method: POST
path: "/api/v1/admin/vendors/{env}/revoke"
tags: ["admin-vendors"]
---

# Revoke Oauth

`POST /api/v1/admin/vendors/{env}/revoke`

Admin-initiated mailbox disconnect.

Clears the refresh token from Secrets Manager + invalidates the
in-process access-token cache. Returns 204 on success. Idempotent —
safe to call even when no mailbox is currently connected.

## Path parameters

- `env` 'staging' | 'prod', required

## Response `204`

Successful Response

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/prototyping/apis/prototyping-io-api.md) · [All operations](https://skmtc.dev/prototyping/apis/prototyping-io-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/prototyping/prototyping-io-api/revisions/f4a0079fbb57/schema)