Add or remove project members

Request

Add organization members to a project, or remove them from it.

action is add or remove. memberIds accepts at most 50 member IDs. A member who already has the requested access is left unchanged and omitted from affectedMemberIds.

Members with the user role need this access to use an invite-only project. Organization admins can access every project. Members can access a project that is not invite-only without being added here.

For add, every ID must belong to a member of the organization. If one ID is unknown, the request returns 404 and adds no members. For remove, unknown IDs are ignored. Repeated IDs are treated as one, and an empty list changes nothing.

An API key limited to projects can change membership only for those projects.

Security

ApiKey(Required scopes: projectMembers.update)

Path

idstringrequired

Project ID

Bodyapplication/jsonrequired

actionstringrequired

Action to perform.

Enum:"add""remove"

memberIdsArray of strings, <= 50 itemsrequired

Member IDs to add to or remove from this project.

Payload

{
  "action": "add",
  "memberIds": [
    "string"
  ]
}

Responses

Success

Bodyapplication/json

affectedMemberIdsArray of stringsrequired

Newly-added or -removed member IDs.

Response

{
  "affectedMemberIds": [
    "string"
  ]
}