Organizations > User organization roles
User organization roles define user permissions in the organization. The endpoints discussed further retrieve information about user roles in the organization. Use the /users/{userId}/user-organization-roles/{organizationIdId} to manage user organization roles. Check out the overview of user organization roles and the associated user permissions.
Retrieves information about all users and their roles in the organization with the specified organizationId.
Authorize the API call with your API token in the Authorization header with the value: Token your-api-token.
If you don't have an API token yet, please refer to the "Authentication" section to learn how to create one.
The ID of the organization.
11Specifies columns that are returned in the response. Use the cols[] parameter for every column that you want to return in the response. For example GET /endpoint?cols[]=key1&cols[]=key2 to get both key1 and key2 columns in the response.
{"value":["userId","organizationId","userRoleId","invitation","organizationTeamsCount","joinedTeamsCount"]}Successful response
GET /api/v2/organizations/{organizationId}/user-organization-roles HTTP/1.1
Host: eu1.make.com
Authorization: YOUR_API_KEY
Accept: */*
Successful response
{
"userOrganizationRoles": [
{
"userId": 1,
"organizationId": 11,
"usersRoleId": 11,
"invitation": null
},
{
"userId": 2,
"organizationId": 11,
"usersRoleId": 13,
"invitation": "expired"
}
]
}Get user organization role details
Retrieves information about a user role in an organization with the specified userId and organizationId. Get all user role IDs with the API call GET users/roles.
Authorize the API call with your API token in the Authorization header with the value: Token your-api-token.
If you don't have an API token yet, please refer to the "Authentication" section to learn how to create one.
The ID of the organization.
11The ID of the user.
111Specifies columns that are returned in the response. Use the cols[] parameter for every column that you want to return in the response. For example GET /endpoint?cols[]=key1&cols[]=key2 to get both key1 and key2 columns in the response.
{"value":["userId","organizationId","userRoleId","invitation","organizationTeamsCount","joinedTeamsCount"]}Successful response
GET /api/v2/organizations/{organizationId}/user-organization-roles/{userId} HTTP/1.1
Host: eu1.make.com
Authorization: YOUR_API_KEY
Accept: */*
Successful response
{
"userOrganizationRole": {
"userId": 111,
"organizationId": 11,
"usersRoleId": 11,
"invitation": null
}
}Transfer organization ownership to the specified user. Only the user that has the user role "Owner" in the organization can transfer ownership.
Authorize the API call with your API token in the Authorization header with the value: Token your-api-token.
If you don't have an API token yet, please refer to the "Authentication" section to learn how to create one.
The ID of the organization.
11The ID of the user.
Successful response
POST /api/v2/organizations/{organizationId}/user-organization-roles/transfer HTTP/1.1
Host: eu1.make.com
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 12
{
"userId": 1
}Successful response
{
"userOrganizationRoles": [
{
"userId": 12,
"organizationId": 10,
"usersRoleId": 11,
"invitation": null
},
{
"userId": 1,
"organizationId": 10,
"usersRoleId": 12,
"invitation": null
}
]
}Last updated