Create project role assignment
Grants a user or group an explicit role on a project. Returns 409 if that principal already has an explicit assignment on the project.Set principalType to user or group:- `user`: principalId is the user email (string)
- `group`: principalId is the group id (positive integer)Assign to a user:
``json
{
"principalType": "user",
"principalId": "alice@company.com",
"projectId": 187520,
"roleId": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
}
``Assign to a group:
``json
{
"principalType": "group",
"principalId": 42,
"projectId": 187520,
"roleId": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
}
``
/user-management/1/project-role-assignmentsAuthorizations
AuthorizationstringrequiredContact Amplitude Support to obtain your organization's org API key and org secret key.Send them as HTTP Basic credentials on every request: org API key in the username field, org secret key in the password field. Also include orgId as a query parameter for your organization.401: invalid credentials. 403 (org_not_enrolled): your organization is not enabled for this API.
Query parameters
orgIdintegerrequiredOrganization id for the authenticated API caller. Must match the organization tied to the org key pair in the Authorization header.
min: 1Body
application/jsonprojectIdintegerrequiredmin: 0roleIdstringrequiredformat: uuidprincipalTypestringrequiredgroupprincipalIdintegerrequiredmin: 0Response
application/jsonidstringrequiredmin length: 1principalTypestringrequiredWhether the assignment targets an individual user (user) or a group (group)
usergroupuserprincipalIdstringrequiredmin length: 1projectIdintegerrequiredmin: 0roleIdstringrequiredformat: uuidtypestringrequiredRFC 7807 problem type URI
format: urititlestringrequiredstatusintegerrequireddetailstringnullableinstancestringnullableerror_codestringrequiredinvalid_requestauthentication_requiredinsufficient_permissionsorg_id_mismatchorg_not_enrollednot_foundconflictrate_limitedinternal_errorretryablebooleanrequiredretry_after_secondsintegernullabletypestringrequiredRFC 7807 problem type URI
format: urititlestringrequiredstatusintegerrequireddetailstringnullableinstancestringnullableerror_codestringrequiredinvalid_requestauthentication_requiredinsufficient_permissionsorg_id_mismatchorg_not_enrollednot_foundconflictrate_limitedinternal_errorretryablebooleanrequiredretry_after_secondsintegernullabletypestringrequiredRFC 7807 problem type URI
format: urititlestringrequiredstatusintegerrequireddetailstringnullableinstancestringnullableerror_codestringrequiredinvalid_requestauthentication_requiredinsufficient_permissionsorg_id_mismatchorg_not_enrollednot_foundconflictrate_limitedinternal_errorretryablebooleanrequiredretry_after_secondsintegernullabletypestringrequiredRFC 7807 problem type URI
format: urititlestringrequiredstatusintegerrequireddetailstringnullableinstancestringnullableerror_codestringrequiredinvalid_requestauthentication_requiredinsufficient_permissionsorg_id_mismatchorg_not_enrollednot_foundconflictrate_limitedinternal_errorretryablebooleanrequiredretry_after_secondsintegernullabletypestringrequiredRFC 7807 problem type URI
format: urititlestringrequiredstatusintegerrequireddetailstringnullableinstancestringnullableerror_codestringrequiredinvalid_requestauthentication_requiredinsufficient_permissionsorg_id_mismatchorg_not_enrollednot_foundconflictrate_limitedinternal_errorretryablebooleanrequiredretry_after_secondsintegernullabletypestringrequiredRFC 7807 problem type URI
format: urititlestringrequiredstatusintegerrequireddetailstringnullableinstancestringnullableerror_codestringrequiredinvalid_requestauthentication_requiredinsufficient_permissionsorg_id_mismatchorg_not_enrollednot_foundconflictrate_limitedinternal_errorretryablebooleanrequiredretry_after_secondsintegernullableWas this helpful?