---
title: "Changes to Create or update a role"
method: PUT
path: "/api/security/role/{name}"
---

# Changes to Create or update a role

`PUT /api/security/role/{name}`

> Every recorded change to this endpoint, newest first.
> 176 revisions in range; 20 not diffed.

## Timeline

Changed in 1 of 176 revisions.

- **2026-09-08** `d2c05b3a3205` — 1 info

## Changes

- **2026-09-08** `d2c05b3a3205` — 1 info
  - added the new optional request property `elasticsearch/global`

---

[Operation](https://skmtc.dev/elastic/apis/kibana-apis/docs/api/security/role/:name/put.md) · [API](https://skmtc.dev/elastic/apis/kibana-apis.md) · [Page](https://skmtc.dev/elastic/apis/kibana-apis/changes/api/security/role/:name/put)