Skip to content
Governance Platform

Update user roles in a project

PUT
/api/v1/organizations/{organizationId}/projects/{projectId}/members/{userId}
 
curl --request PUT \
  --url https://localhost:8080/api/v1/organizations/example/projects/example/members/example \
  --header 'Authorization: <Authorization>' \
  --header 'Content-Type: application/json' \
  --data '{ "roles": [ "project_owner", "implementer" ] }'

Replace the project roles assigned to a user, upserting the assignment when needed

Authorizations

Section titled “Authorizations ”

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “Path Parameters ”
organizationId
required
string

Organization ID or UUID (bare or urn:uuid)

projectId
required
string

Project ID, UUID (bare or urn:uuid), or slug:my-project

userId
required
string

User UUID (bare or urn:uuid) or did:key

Request Body

Section titled “Request Body ”

Updated roles

Media type application/json
object
roles
required

At least one project-level role

Array<string>
>= 1 items
Example 
[
  "project_owner",
  "implementer"
]

Responses

Section titled “ Responses ”

200

Section titled “200 ”

User roles updated successfully

Media type application/json

A user’s assignment to a single project, and the roles it grants

object
assignedAt
string format: date-time
organizationId
integer
projectId
integer
roles
Array<string>
status
string
userId
string
Example generated
{
  "assignedAt": "2026-04-15T12:00:00Z",
  "organizationId": 1,
  "projectId": 1,
  "roles": [
    "example"
  ],
  "status": "example",
  "userId": "example"
}

400

Section titled “400 ”

Invalid request

Media type application/json

Error body returned across the auth endpoints; the message is human-readable and not a stable identifier

object
error
string
error_description
string
Example 
{
  "error": "Unauthorized",
  "error_description": "Invalid token"
}

401

Section titled “401 ”

Unauthorized

Media type application/json

Error body returned across the auth endpoints; the message is human-readable and not a stable identifier

object
error
string
error_description
string
Example 
{
  "error": "Unauthorized",
  "error_description": "Invalid token"
}

403

Section titled “403 ”

Forbidden - requires Organization Owner or Project Owner role

Media type application/json

Error body returned across the auth endpoints; the message is human-readable and not a stable identifier

object
error
string
error_description
string
Example 
{
  "error": "Unauthorized",
  "error_description": "Invalid token"
}

404

Section titled “404 ”

Organization, project, or user not found

Media type application/json

Error body returned across the auth endpoints; the message is human-readable and not a stable identifier

object
error
string
error_description
string
Example 
{
  "error": "Unauthorized",
  "error_description": "Invalid token"
}

500

Section titled “500 ”

Internal server error

Media type application/json

Error body returned across the auth endpoints; the message is human-readable and not a stable identifier

object
error
string
error_description
string
Example 
{
  "error": "Unauthorized",
  "error_description": "Invalid token"
}