github.com/phrase/openapi@v0.0.0-20240514140800-49e8a106740e/paths/members/update.yaml (about)

     1  ---
     2  summary: Update a member
     3  description: Update user permissions in the account. Developers and translators need <code>project_ids</code> and <code>locale_ids</code> assigned to access them. Access token scope must include <code>team.manage</code>.
     4  operationId: member/update
     5  tags:
     6  - Members
     7  parameters:
     8  - "$ref": "../../parameters.yaml#/X-PhraseApp-OTP"
     9  - "$ref": "../../parameters.yaml#/account_id"
    10  - "$ref": "../../parameters.yaml#/id"
    11  responses:
    12    '200':
    13      description: OK
    14      content:
    15        application/json:
    16          schema:
    17            "$ref": "../../schemas/member.yaml#/member"
    18      headers:
    19        X-Rate-Limit-Limit:
    20          "$ref": "../../headers.yaml#/X-Rate-Limit-Limit"
    21        X-Rate-Limit-Remaining:
    22          "$ref": "../../headers.yaml#/X-Rate-Limit-Remaining"
    23        X-Rate-Limit-Reset:
    24          "$ref": "../../headers.yaml#/X-Rate-Limit-Reset"
    25    '400':
    26      "$ref": "../../responses.yaml#/400"
    27    '401':
    28      "$ref": "../../responses.yaml#/401"
    29    '403':
    30      "$ref": "../../responses.yaml#/403"
    31    '404':
    32      "$ref": "../../responses.yaml#/404"
    33    '429':
    34      "$ref": "../../responses.yaml#/429"
    35  x-code-samples:
    36  - lang: Curl
    37    source: |-
    38      curl "https://api.phrase.com/v2/accounts/:account_id/members/:id" \
    39        -u USERNAME_OR_ACCESS_TOKEN \
    40        -X PATCH \
    41        -d '{"role":"Developer","strategy":"set","project_ids":"abcd1234abcd1234abcd1234,abcd1234abcd1234abcd1235","locale_ids":"abcd1234abcd1234abcd1234,abcd1234abcd1234abcd1235","default_locale_codes":["de","en"],"space_ids":["abcd1234abcd1234abcd1234","abcd1234abcd1234abcd1235"],"permissions":{"create_upload":true,"review_translations":true}}' \
    42        -H 'Content-Type: application/json'
    43  - lang: CLI v2
    44    source: |-
    45      phrase members update \
    46      --account_id <account_id> \
    47      --id <id> \
    48      --data '{"role":"Developer", "strategy":"set", "project_ids":"abcd1234abcd1234abcd1234,abcd1234abcd1234abcd1235", "locale_ids":"abcd1234abcd1234abcd1234,abcd1234abcd1234abcd1235", "default_locale_codes":["de","en"], "space_ids":["abcd1234abcd1234abcd1234","abcd1234abcd1234abcd1235"], "permissions":"{"create_upload"=>true, "review_translations"=>true}"}' \
    49      --access_token <token>
    50  requestBody:
    51    required: true
    52    content:
    53      application/json:
    54        schema:
    55          type: object
    56          title: member/update/parameters
    57          properties:
    58            strategy:
    59              description: Update strategy, can be any of set, add, remove. If provided, it will set, add or remove given spaces, projects and locale ids from users access list.
    60              type: string
    61              example: set
    62            role:
    63              description: Member role, can be any of of Admin, ProjectManager, Developer, Designer, Translator
    64              type: string
    65              example: Developer
    66            project_ids:
    67              description: 'List of project ids the user has access to. '
    68              type: string
    69              example: abcd1234abcd1234abcd1234,abcd1234abcd1234abcd1235
    70            locale_ids:
    71              description: List of locale ids the user has access to.
    72              type: string
    73              example: abcd1234abcd1234abcd1234,abcd1234abcd1234abcd1235
    74            default_locale_codes:
    75              description: List of default locales for the user.
    76              type: array
    77              items:
    78                type: string
    79              example:
    80              - en
    81              - fi
    82            space_ids:
    83              description: List of spaces the user is assigned to.
    84              type: array
    85              items:
    86                type: string
    87              example:
    88              - abcd1234abcd1234abcd1234
    89              - abcd1234abcd1234abcd1235
    90            permissions:
    91              description: Additional permissions depending on member role. Available permissions are <code>create_upload</code> and <code>review_translations</code>
    92              type: object
    93              additionalProperties:
    94                type: string
    95              example:
    96                create_upload: true
    97                review_translations: true
    98  x-cli-version: '2.5'