> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cope.com/llms.txt
> Use this file to discover all available pages before exploring further.

# community.member.role_changed

> A member's role changed.

# community.member.role\_changed

> Generated from COPE public event contracts. Do not edit this page by hand.

Fires when a member's role changes.

## Delivery Contract

| Field           | Value                                                                                |
| --------------- | ------------------------------------------------------------------------------------ |
| Encoding        | CloudEvents 1.0 structured JSON                                                      |
| Delivery        | At least once                                                                        |
| Idempotency     | Use the CloudEvents `source` + `id` tuple, or COPE `idempotency_key` when available. |
| Source          | `cope.community`                                                                     |
| Subject pattern | `member:<identifier>`                                                                |
| Category        | Community                                                                            |
| Availability    | Available in the public webhook reference.                                           |
| Schema title    | community.member.role\_changed v1 payload                                            |
| Schema ID       | `https://schemas.cope.com/events/community.member.role_changed/v1`                   |

## Payload Fields

| Field          | Required | Type      | Allowed Values | Description |   |
| -------------- | -------- | --------- | -------------- | ----------- | - |
| `changed_by`   | no       | `string`  | -              | -           |   |
| `community_id` | yes      | `string`  | -              | -           |   |
| `is_expert`    | no       | `boolean` | -              | -           |   |
| `new_role`     | yes      | `string`  | -              | -           |   |
| `old_role`     | no       | \`string  | null\`         | -           | - |
| `user_id`      | yes      | `string`  | -              | -           |   |

## Example CloudEvent

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "data": {
    "community_id": "example_id",
    "new_role": "example_new_role",
    "user_id": "example_id"
  },
  "datacontenttype": "application/json",
  "dataschema": "https://schemas.cope.com/events/community.member.role_changed/v1",
  "id": "community.member.role_changed:example",
  "idempotency_key": "community.member.role_changed:example",
  "source": "cope.community",
  "specversion": "1.0",
  "subject": "member:example",
  "time": "2026-05-05T12:00:00.000Z",
  "type": "community.member.role_changed"
}
```

## Compatibility

Fields may be added within the same major version. Removing or changing the meaning of a documented field requires a new event version.