---
title: "Revoke partner access"
method: POST
path: "/api/v1/account/partner-access/revoke"
tags: ["account"]
---

# Revoke partner access

`POST /api/v1/account/partner-access/revoke`

## Request

- Base URL: `https://point11.ai`
- URL: `https://point11.ai/api/v1/account/partner-access/revoke`
- Auth: OAuth 2 (authorization code, authorization URL `https://auth.point11.ai/oauth2/authorize`, token URL `https://auth.point11.ai/oauth2/token`)

Remove a partner firm's access to the organization by its access id (from account_partner_access_list). The user must approve. Everyone at the firm loses access on their next request, and so does each person who joined the organization through an invitation from its people, unless they now own it; the invitations its people sent here and the API keys they can no longer issue are revoked; the removal is recorded in the organization's and the firm's audit logs. Only the organization's own owners and admins can do this, not the firm's people.

## Headers

- `Point11-Organization` string, uuid
- `Idempotency-Key` string, uuid, required
- `Point11-Confirm` 'true', required

## Request body

- AccountPartnerAccessRevokeRequest
  - `id` string, uuid, required: The partner's access id

## Response `200`

Success.

- AccountPartnerAccessRevokeResponse
  - `id` string, uuid, required
  - `revoked` true, required
  - `revokedApiKeys` integer, required: API keys the firm's people created here that this removal revoked

## Other responses

- `400`: The input, query, or Idempotency-Key is invalid.
- `401`: The bearer is missing, expired, or not accepted.
- `402`: Billing refused the write: the code names the reason and `details.reason` carries it.
- `403`: The credential lacks the operation's scope or role, or the operation needs a different door.
- `404`: The resource or organization does not exist for this caller.
- `405`: This path takes another HTTP method, named in `Allow`.
- `409`: The request conflicts with current state or with prior use of its Idempotency-Key.
- `413`: The request, or the answer it asks for, is too large; narrow it.
- `429`: The credential's rate budget is spent; retry after `Retry-After` seconds.
- `500`: An unexpected server failure; retry later. Only `request_id` identifies it.
- `503`: A dependency is temporarily unavailable; retry after `Retry-After` seconds.
- `default`: Another status a product answers for its own refusal (for example `415` for an unsupported attachment); branch on `code`.

---

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