---
title: "Set the partner access level"
method: PUT
path: "/v1/organizations/{organization_id}/partner-access"
tags: ["organizations"]
---

# Set the partner access level

`PUT /v1/organizations/{organization_id}/partner-access`

## Request

- Base URL: `https://api.ethiack.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.ethiack.com/v1/organizations/{organization_id}/partner-access`
- Auth: none declared

Set how much delegated access this organization grants its partner.

Args:
    organization_id (int): Identifier of the organization.
    body (PartnerAccessUpdateRequest): The new consent level.
    db (AsyncSession): Request-scoped database session.
    context (ActiveContext): Resolved caller identity and scope.

## Path parameters

- `organization_id` integer, required

## Request body

- PartnerAccessUpdateRequest: Body for updating an organization's partner access consent. Attributes: level (PartnerAccessLevel): Delegated access granted to the managing partner.
  - `level` 'none' | 'read_only' | 'full', required: How much delegated access the org grants its managing partner. Stored by member NAME (``NONE``/``READ_ONLY``/``FULL``) per the project's enum-column convention; the lowercase ``value`` is the wire form that reaches Cerbos principal attributes. Attributes: NONE: No delegated access (the default; replaces the legacy ``accept_impersonation = false``). READ_ONLY: The partner may operate the org read-only. Enforced by the ``operating_partner`` / ``operating_partner_writer`` Cerbos composites (ENG-1467): ``operating_partner`` grants reads at any access level, while ``operating_partner_writer`` additionally requires ``operating_access == "full"``, so a ``READ_ONLY``-pinned partner never reaches a write. FULL: The partner may operate the org, reads and writes (models legacy impersonation's write surface).

## Response `204`

Successful Response

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/ethiack/apis/ethiack-api.md) - [All operations](https://skmtc.dev/ethiack/apis/ethiack-api/llms.txt) - [OpenAPI document](https://skmtc.dev/ethiack/apis/ethiack-api/revisions/4eaba89bfebf?raw)