---
title: "Role Deleted"
method: POST
path: "role.deleted"
---

# Role Deleted

`POST role.deleted` (webhook)

Triggered when a role is deleted

## Payload

- RoleDeletedEvent — Payload delivered for the role.deleted webhook event.
  - `spec_version` string, required — The webhook specification version
  - `id` string, required — Unique identifier for the webhook event (must be prefixed with "evt_")
  - `type` 'role.deleted', required — The event type
  - `occurred_at` string, date-time, required — When the event occurred (ISO 8601 format)
  - `environment_id` string, required — The environment ID where the event occurred
  - `organization_id` string — The organization ID (if applicable)
  - `object` 'Role', required — The type of object that triggered the webhook
  - `data` RoleEventData, required — Role payload for role.* webhook events.
    - `id` string, required — Role identifier
    - `name` string, required — Role name
    - `display_name` string — Human-readable role name
    - `description` string — Role description
    - `extends` string — Parent role this role extends, if any
  - `display_name` string — Human-readable display name for the event

## Acknowledgement `200`

Webhook received successfully

---

[API](https://skmtc.net/scalekit/apis/scalekit-api-reference.md) · [All operations](https://skmtc.net/scalekit/apis/scalekit-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/scalekit/scalekit-api-reference/versions/a40d5d4650e5/schema)