v1

latestOpenAPI 3.0.0Proprietary2026-07-26316155742.7 KB
Members

Update a member

Update user permissions in the account. Developers and translators need project_ids and locale_ids assigned to access them. Access token scope must include team.manage.

patch/accounts/{account_id}/members/{id}

Path parameters

account_idstring required

Account ID

idstring required

ID

Headers

X-PhraseApp-OTPstring

Two-Factor-Authentication token (optional)

Request body

strategystring

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.

rolestring

Member role, can be any of of Admin, ProjectManager, Developer, Designer, Translator

project_idsstring

List of project ids the user has access to.

locale_idsstring

List of locale ids the user has access to.

default_locale_codesstring[]

List of default locales for the user.

space_idsstring[]

List of spaces the user is assigned to.

permissionsobject

Additional permissions depending on member role. Available permissions are create_upload and review_translations

Example request

{
  "strategy": "set",
  "role": "Developer",
  "project_ids": "abcd1234abcd1234abcd1234,abcd1234abcd1234abcd1235",
  "locale_ids": "abcd1234abcd1234abcd1234,abcd1234abcd1234abcd1235",
  "default_locale_codes": [
    "en",
    "fi"
  ],
  "space_ids": [
    "abcd1234abcd1234abcd1234",
    "abcd1234abcd1234abcd1235"
  ],
  "permissions": {
    "create_upload": true,
    "review_translations": true
  }
}

Response

OK

idstring
emailstring
usernamestring
created_atstring date-time
last_activity_atstring date-time
rolestring
permissionsobject
default_locale_codesstring[]

Example response

{
  "id": "acbdacbdacbdacbdacbdacbd",
  "email": "foo@bar.com",
  "username": "myname",
  "created_at": "2020-12-07T12:56:21Z",
  "last_activity_at": "2020-12-09T12:56:21Z",
  "role": "Manager",
  "projects": [
    {
      "id": "abcd1234cdef1234abcd1234cdef1234",
      "name": "My Android Project",
      "main_format": "xml",
      "created_at": "2015-01-28T09:52:53Z",
      "updated_at": "2015-01-28T09:52:53Z",
      "locales": [
        {
          "id": "abcd1234cdef1234abcd1234cdef1234",
          "name": "English",
          "code": "en-Gb"
        }
      ]
    }
  ],
  "permissions": [
    {
      "create_upload": true,
      "review_translations": true
    }
  ],
  "default_locale_codes": [
    "en",
    "fi"
  ],
  "teams": [
    {
      "id": "04d36d845576b9d494d05e0b70fe813c",
      "name": "Team 1",
      "created_at": "2020-12-07T12:56:21Z",
      "updated_at": "2020-12-07T12:56:21Z"
    }
  ],
  "spaces": [
    {
      "id": "04d36d845576b9d494d05e0b70fe813b",
      "name": "Space2",
      "created_at": "2020-12-07T12:56:21Z",
      "updated_at": "2020-12-07T12:56:21Z",
      "projects_count": 1
    }
  ]
}