Set an explicit stack member

put

https://api.lingohub.com/v2/stacks/{stackId}/members/{memberId}

Creates or fully replaces an explicit assignment at the stack/workspace-member key. Both stack_role_id and the complete language_permissions map are required and non-null; an empty map clears explicit language rows. Repeating an unchanged role/map does not write. Workspace owners and current/requested stack OWNER roles are protected. Requires stack settings-management permission. Optional If-Match checks the current GET representation; * on a missing assignment returns 412. PUT omits ETag: GET the resulting assignment for a current validator. Inherited workspace access may exist independently of these rows.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

stackId

string

required

^stack_[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$

Public id that is created from the type prefix of the corresponding resource and its UUID. I.e : For a stack, a valid value would be : stack_0197c8f2-5a6b-7cde-8f12-3456789abcde

memberId

string

required

^wsu_[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$

Public id composed of the resource type prefix and its UUID.

Body Params

Request body to create or fully replace an explicit stack assignment's role and configured language map. Both fields are required; use an empty map to clear explicit language permissions.

stack_role_id

string

required

^stackr_[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$

Public id composed of the resource type prefix and its UUID.

language_permissions

object

required

Complete map of configured stack language codes to explicit permissions. The map and each value must be non-null; an empty object removes all explicit language rows. This is not effective access.

Headers

If-Match

string

Optional precondition. Send the quoted ETag from a GET of this resource. The mutation only runs if a strong tag matches the current representation, checked under the write lock. A comma-separated list is allowed; '*' requires an existing representation. Weak tags never match. Omit this header for an unconditional write. For an action, use the ETag from GET of the target resource, without the action suffix. A stale tag returns 412; read the current state before retrying.

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Responses

Language

Credentials

Bearer

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

application/problem+json

200Assignment replaced or already identical.

201Explicit assignment created.

400The request is malformed: an unknown or invalid query parameter, an invalid id in the path, or a body that is not valid JSON. code names the problem, errors the parameter or field.

401Invalid or missing API key.

403Insufficient permissions.

404The resource does not exist, or the API key cannot see it.

409Owner membership changes are protected (owner_membership_protected).

412The current representation does not match If-Match (precondition_failed). No change was applied.

422The request is well-formed, but values are invalid; errors points at each of them.

429The API rate limit was exceeded. Wait for the number of seconds given in the Retry-After header, then retry.

500An unexpected internal server error occurred.

503The service is temporarily unavailable. Retry after the number of seconds in the Retry-After header.