PUT /openapi/memorylake/admin/v1/members/{principal_id}/access-scope
Replaces the scope of each listed resource type. A scope limits a member; it never grants more than the member’s role allows. Project instances need their workspace_id. A restricted type may list no instances: the member then reaches none of that type.The response carries an ETag header (the same value a GET of this resource returns). Send it back in If-Match to make the write conditional: when the resource has changed in the meantime the write is refused with 412 and nothing is changed. The check narrows, but does not fully close, the window for a concurrent overwrite — two writers that pass it at the same instant can both write.
Permission required:member:set_scope
When the member is not ranked below you: the owner, an admin, or a holder of an admin-level custom role — only the owner may limit an admin: team owner only
Changes that give someone an admin role, or that reduce what an admin can reach, also require the team owner or an admin.
Path Parameters
string
required
Identifier of the member (principal_id)
Headers
string
Optional. The ETag from a previous read of this resource. The write is refused with 412 when the resource has changed since; omit it to overwrite unconditionally.
Request Body
string
required
Why the change is made; recorded in the audit log. At most 255 bytes (UTF-8).
array
required
Each listed resource type’s scope is replaced by the given one; types not listed keep their current scope.
Show Access Scope Entry object
string
required
all = every instance; instances = only the listed ones
string
required
Resource type, e.g. memorylake:project
array
Instances when mode is instances; may be empty
Show Access Scope Instance object
string
required
Instance id
array
Omit for every action the member’s role allows
boolean
Echo of a read-only row. Instances marked true are skipped on write — permission levels are set on the resource, not through scope.
all = every instance; instances = only the listed ones
string
Resource type, e.g. memorylake:project (see GET /permission-catalog)
array
Read-only. Instance-level actions the member’s role grants for this type — the most a scope entry can allow.
array
The instances, when mode is instances
Show Access Scope Instance object
string
Instance id, as returned by the data API
array
Actions allowed on this instance. Omit for every action the member’s role allows.
array
Read-only. The subset of actions the member’s CURRENT role still grants.
string
Read-only. The permission level, when via_permission_level is true. One of: read, write, manage.
array
Read-only. Actions stored here that the member’s current role no longer grants.
boolean
Read-only. The member reaches this instance through a permission level granted on it, not through this scope. May be echoed back on write; such instances are skipped.
string
Parent workspace of a project instance. Required when writing a project instance.