Roles

Delete a role

curl -X DELETE https://api.subscriby.net/v1/roles/$ROLE_ID \
  -H "Authorization: Bearer $SUBSCRIBY_TOKEN" \
  -H "Idempotency-Key: $(uuidgen)"

Returns 204 No Content, and detaches the role's permissions on the way out. Anyone currently holding the role loses whatever it granted them; they stay in the team. Not gated by tier. Emits role.deleted.

Restricted to whoever created the role, unless the caller owns the team. Belonging to a team is not licence to dismantle how everyone else in it is permissioned.

delete/v1/roles/{role}

Request

  • Base URL: https://api.subscriby.net
  • URL: https://api.subscriby.net/v1/roles/{role}
  • Auth: HTTP bearer

Path parameters

rolestring uuid required

The role, resolved by the route binder.

Headers

Idempotency-Keystring uuid required

A key unique to this operation, such as a fresh UUID. The same key replays the original 2xx response for 24 hours (with Idempotent-Replay: true), so a retry after a timeout never repeats the write; the same key with a different body is refused with 409.

Response

No content

Changes

No recorded changes to this operation across all 1 revision of this API.