---
title: "PUT /role_definitions/{id}/"
method: PUT
path: "/role_definitions/{id}/"
tags: ["role_definitions"]
---

# PUT /role_definitions/{id}/

`PUT /role_definitions/{id}/`

Update a RoleDefinition.

## Path parameters

- `id` integer, required

## Request body

- RoleDefinitionCreate
  - `permissions` PermissionsEnum[], required
  - `content_type` union — The type of resource this applies to * `eda.activation` - Activation * `eda.auditrule` - Audit Rule * `eda.decisionenvironment` - Decision Environment * `eda.edacredential` - Eda Credential * `eda.eventstream` - Event Stream * `eda.project` - Project * `eda.rulebook` - Rulebook * `eda.rulebookprocess` - Rulebook Process * `shared.organization` - Organization * `shared.team` - Team
    - 'eda.activation' | 'eda.auditrule' | 'eda.decisionenvironment' | 'eda.edacredential' | 'eda.eventstream' | 'eda.project' | 'eda.rulebook' | 'eda.rulebookprocess' | 'shared.organization' | 'shared.team' — * `eda.activation` - Activation * `eda.auditrule` - Audit Rule * `eda.decisionenvironment` - Decision Environment * `eda.edacredential` - Eda Credential * `eda.eventstream` - Event Stream * `eda.project` - Project * `eda.rulebook` - Rulebook * `eda.rulebookprocess` - Rulebook Process * `shared.organization` - Organization * `shared.team` - Team
    - unknown
  - `name` string, required
  - `description` string

## Response `200`

Return an updated RoleDefinition.

- RoleDefinition
  - `id` integer, required
  - `url` string, required
  - `related` object, required
  - `summary_fields` object, required
  - `permissions` PermissionsEnum[], required
  - `content_type` union — The type of resource this applies to * `eda.activation` - Activation * `eda.auditrule` - Audit Rule * `eda.decisionenvironment` - Decision Environment * `eda.edacredential` - Eda Credential * `eda.eventstream` - Event Stream * `eda.project` - Project * `eda.rulebook` - Rulebook * `eda.rulebookprocess` - Rulebook Process * `shared.organization` - Organization * `shared.team` - Team
    - 'eda.activation' | 'eda.auditrule' | 'eda.decisionenvironment' | 'eda.edacredential' | 'eda.eventstream' | 'eda.project' | 'eda.rulebook' | 'eda.rulebookprocess' | 'shared.organization' | 'shared.team' — * `eda.activation` - Activation * `eda.auditrule` - Audit Rule * `eda.decisionenvironment` - Decision Environment * `eda.edacredential` - Eda Credential * `eda.eventstream` - Event Stream * `eda.project` - Project * `eda.rulebook` - Rulebook * `eda.rulebookprocess` - Rulebook Process * `shared.organization` - Organization * `shared.team` - Team
    - unknown
  - `modified` string, date-time, required — The date/time this resource was created
  - `created` string, date-time, required — The date/time this resource was created
  - `name` string, required
  - `description` string
  - `managed` boolean, required
  - `modified_by` integer, nullable, required — The user who last modified this resource
  - `created_by` integer, nullable, required — The user who created this resource

## Changes

- **2026-07-17** `c04fc5f09692` — 42 breaking, 17 warning, 69 info
  - removed the enum value `eda.add_credentialtype` of the request property `permissions/items/` (media type: application/json)
  - removed the enum value `eda.add_credentialtype` of the request property `permissions/items/` (media type: application/x-www-form-urlencoded)
  - removed the enum value `eda.add_credentialtype` of the request property `permissions/items/` (media type: multipart/form-data)
  - removed the enum value `eda.add_team` of the request property `permissions/items/` (media type: application/json)
  - …124 more
- **2024-04-29** `feeac1db5ade` — 9 breaking, 3 info
  - removed the enum value `eda.add_extravar` of the request property `permissions/items/` (media type: application/json)
  - removed the enum value `eda.add_extravar` of the request property `permissions/items/` (media type: application/x-www-form-urlencoded)
  - removed the enum value `eda.add_extravar` of the request property `permissions/items/` (media type: multipart/form-data)
  - removed the enum value `eda.extravar` of the request property `content_type/allOf[#/components/schemas/ContentTypeEnum]/` (media type: application/json)
  - …8 more
- **2024-04-23** `cbf68ddd9760` — 1 info
  - endpoint added
- **2023-04-25** `62d33b790834` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/ansible/apis/event-driven-ansible-api/changes/role_definitions/:id/put.md)

---

[API](https://skmtc.dev/ansible/apis/event-driven-ansible-api.md) · [All operations](https://skmtc.dev/ansible/apis/event-driven-ansible-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ansible/event-driven-ansible-api/revisions/c04fc5f09692/schema)