v1

latestOpenAPI 3.0.3Apache 2.02026-07-142201861.5 MB

Organizations

Update an Organization Member's Roles

Update a member's organization-level and team-level roles.

Note that for changing organization-roles, this endpoint is restricted to user auth tokens. Additionally, both the original and desired organization role must have the same or lower permissions than the role of the organization user making the request

For example, an organization Manager may change someone's role from Member to Manager, but not to Owner.

put/api/0/organizations/{organization_id_or_slug}/members/{member_id}/

Path parameters

organization_id_or_slugstring required

The ID or slug of the organization the resource belongs to.

member_idstring required

The ID of the member to update.

Request body

orgRole'billing' | 'member' | 'manager' | 'owner' | 'admin'

The organization role of the member. The options are:

billing - Can manage payment and compliance details.
member - Can view and act on events, as well as view most other data within the organization.
manager - Has full management access to all teams and projects. Can also manage the organization's membership.
owner - Has unrestricted access to the organization, its data, and its settings. Can add, modify, and delete projects and members, as well as make billing and plan changes.
admin - Can edit global integrations, manage projects, and add/remove teams. They automatically assume the Team Admin role for teams they join. Note: This role can no longer be assigned in Business and Enterprise plans. Use TeamRoles instead.

teamRolesobject[] nullable

Configures the team role of the member. The two roles are:

contributor - Can view and act on issues. Depending on organization settings, they can also add team members.
admin - Has full management access to their team's membership and projects.

{
    "teamRoles": [
        {
            "teamSlug": "ancient-gabelers",
            "role": "admin"
        },
        {
            "teamSlug": "powerful-abolitionist",
            "role": "contributor"
        }
    ]
}

Response

rolestring

roleNamestring

idstring required

emailstring required

namestring required

orgRolestring required

pendingboolean required

expiredboolean required

dateCreatedstring date-time required

inviteStatusstring required

inviterNamestring nullable required

teamsstring[] required

invite_linkstring nullable required

isOnlyOwnerboolean required