# Update Member Role

`PATCH /members/{userId}` · Core · Members & End Users

Changes the project role of an existing project member. Does not affect the user's org-level membership or memberships on other projects. Requires `PROJECT_ADMIN` on the project or `ORG_ADMIN`.

## Parameters

| Name | In | Required | Description |
|---|---|---|---|
| `userId` | path | yes | The member's user id (`usr_...`). Example: `"usr_demo00000001"`. |
| `projectSlug` | path | yes | The project's slug: the path segment after `@`. It is unique within the org. Example: `"storefront"`. |

## Request body

| Field | Type | Required | Description |
|---|---|---|---|
| `role` | enum ("PROJECT_ADMIN", "PROJECT_EDITOR", "PROJECT_MEMBER", "PROJECT_VIEWER", "PROJECT_AUDITOR", "PROJECT_AUTHOR", "PROJECT_ANALYST") | yes | The member's new project role: `PROJECT_ADMIN`, `PROJECT_EDITOR`, `PROJECT_MEMBER`, `PROJECT_VIEWER`, `PROJECT_AUDITOR`, `PROJECT_AUTHOR` or `PROJECT_ANALYST`. |

```json
{
  "role": "PROJECT_ADMIN"
}
```

## Responses

- **200**: Success

| Field | Type | Required | Description |
|---|---|---|---|
| `data` | object | yes | A project member. |
| `data.userId` | string | yes | The member's user id (`usr_...`). |
| `data.projectId` | string | yes | The project's id (`proj_...`). |
| `data.role` | enum ("PROJECT_ADMIN", "PROJECT_EDITOR", "PROJECT_MEMBER", "PROJECT_VIEWER", "PROJECT_AUDITOR", "PROJECT_AUTHOR", "PROJECT_ANALYST") | yes | The member's explicit project role. Org owners and admins also have admin access to every project without a row here, and are listed only if they have one. |
| `data.email` | string | yes | The member's sign-in email address. |
| `data.displayName` | string | yes | The member's display name. |
| `data.invitedAt` | string (date-time) | yes | When the membership was created. |
| `data.acceptedAt` | object | yes | When the membership was accepted, or null while it is still an invitation. |
| _one of_ | | |  |
| _or_ | | |  |
| `data.state` | enum ("invited", "active") | yes | `invited` while `acceptedAt` is null, otherwise `active`. |
| `meta` | object | yes | Request metadata: cost, timing and the request and trace ids. |


## Errors

| HTTP | Code | When |
|---|---|---|
| 401 | `K9O_SESSION_EXPIRED` | Your session has expired; sign in again to continue. |
| 403 | `K9O_ACCESS_DENIED` | You do not have the required role (PROJECT_ADMIN or higher) to change a member's role. |
| 404 | `K9O_END_USER_NOT_FOUND` | No member with the specified user ID was found on this project. |
| 410 | `K9O_SLUG_GONE` | The project slug in the URL has been renamed; update your integration to use the new slug. |

## Code samples

### cURL

```bash
curl -X PATCH 'https://<org>.api-<region>.k9o.io/@storefront/members/<userId>' \
  -H 'Authorization: Bearer $K9O_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
  "role": "PROJECT_ADMIN"
}'
```

### fetch

```javascript
const res = await fetch('https://<org>.api-<region>.k9o.io/@storefront/members/<userId>', {
  method: 'PATCH',
  headers: {
    'Authorization': `Bearer ${process.env.K9O_TOKEN}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
  "role": "PROJECT_ADMIN"
}),
});
const { data, meta } = await res.json();
```


Canonical page: https://docs.kilimanjaro.dev/api-playground/core/update-member-role
