---
title: "Revoke platform-admin access"
method: POST
path: "/v3/platform-admins/revoke"
tags: ["Auth"]
---

# Revoke platform-admin access

`POST /v3/platform-admins/revoke`

Soft-revokes platform-admin access for a Google email address. Requires a
valid platform session and CSRF token because this is an unsafe
cookie-authenticated write.

## Request body

- PlatformAdminAccessRequest
  - `googleEmail` string, email, required — Google Workspace email address to grant or revoke.

## Response `200`

Platform-admin access was revoked.

- object
  - `data` PlatformAdminRevokeAccessResult, required
    - `admin` PlatformAdminAccess, required
      - `id` string, uuid, required
      - `googleEmail` string, email, required
      - `createdAt` string, date-time, required
      - `revokedAt` string, date-time, nullable, required
    - `state` 'revoked', required
  - `meta` PaginationMeta, required
    - `total` integer — Exact total count when the endpoint provides one.
    - `hasMore` boolean — Indicates whether another page exists beyond the current page.
    - `offset` integer
    - `limit` integer — Echoed page size after endpoint-side clamping.
    - `timestamp` string, date-time, required
    - `chainId` string — Comma-separated chain IDs for multi-chain responses.
    - `degradedProviders` string[] — Live providers whose data is incomplete in this response.

## Other responses

- `400` — Malformed JSON request body.
- `401` — Missing, invalid, or expired platform-admin session.
- `403` — Inactive platform-admin access, missing CSRF token, or mismatched CSRF token.
- `404` — Platform-admin access was not found.
- `409` — Platform-admin access was already revoked.
- `422` — Missing or invalid Google email.

---

[API](https://skmtc.dev/euler/apis/euler-data-api-v3.md) · [All operations](https://skmtc.dev/euler/apis/euler-data-api-v3/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/euler/euler-data-api-v3/revisions/9573a5fbd4a6/schema)