---
title: "Update"
method: PUT
path: "/roles/{id}"
tags: ["Roles"]
---

# Update

`PUT /roles/{id}`

## Request

- Base URL: `https://api.beyondwords.io/v1`
- URL: `https://api.beyondwords.io/v1/roles/{id}`
- Auth: API key in header `X-Api-Key`

Updates role in a organizaiton

## Request body

- RequestBodyRoleUpdate
  - `name` string
  - `permissions` object, nullable

## Response `200`

successful

- RoleModel
  - `id` integer
  - `key` string
  - `name` string
  - `organization_id` integer
  - `permissions` object, nullable
    - `projects_view` object, nullable
      - `enabled` boolean
    - `projects_create` object, nullable
      - `enabled` boolean
    - `projects_update` object, nullable
      - `enabled` boolean
    - `projects_delete` object, nullable
      - `enabled` boolean
    - `voice_cloning_view` object, nullable
      - `enabled` boolean
    - `voice_cloning_create` object, nullable
      - `enabled` boolean
    - `voice_cloning_update` object, nullable
      - `enabled` boolean
    - `voice_cloning_delete` object, nullable
      - `enabled` boolean
    - `members_view` object, nullable
      - `enabled` boolean
    - `members_create` object, nullable
      - `enabled` boolean
    - `members_update` object, nullable
      - `enabled` boolean
    - `members_delete` object, nullable
      - `enabled` boolean
    - `organizations_view` object, nullable
      - `enabled` boolean
    - `organizations_update` object, nullable
      - `enabled` boolean
    - `roles_view` object, nullable
      - `enabled` boolean
    - `roles_create` object, nullable
      - `enabled` boolean
    - `roles_update` object, nullable
      - `enabled` boolean
    - `roles_delete` object, nullable
      - `enabled` boolean
    - `content_view` object, nullable
      - `enabled` boolean
    - `content_create` object, nullable
      - `enabled` boolean
    - `content_update` object, nullable
      - `enabled` boolean
    - `content_delete` object, nullable
      - `enabled` boolean
    - `background_tracks_view` object, nullable
      - `enabled` boolean
    - `background_tracks_create` object, nullable
      - `enabled` boolean
    - `background_tracks_update` object, nullable
      - `enabled` boolean
    - `background_tracks_delete` object, nullable
      - `enabled` boolean
    - `html_filters_view` object, nullable
      - `enabled` boolean
    - `html_filters_create` object, nullable
      - `enabled` boolean
    - `html_filters_update` object, nullable
      - `enabled` boolean
    - `html_filters_delete` object, nullable
      - `enabled` boolean
    - `rules_view` object, nullable
      - `enabled` boolean
    - `rules_create` object, nullable
      - `enabled` boolean
    - `rules_update` object, nullable
      - `enabled` boolean
    - `rules_delete` object, nullable
      - `enabled` boolean
    - `summarization_settings_view` object, nullable
      - `enabled` boolean
    - `summarization_settings_update` object, nullable
      - `enabled` boolean
    - `video_settings_view` object, nullable
      - `enabled` boolean
    - `video_settings_update` object, nullable
      - `enabled` boolean
    - `organizations_analytics` object, nullable
      - `enabled` boolean
    - `projects_analytics` object, nullable
      - `enabled` boolean
    - `content_analytics` object, nullable
      - `enabled` boolean
    - `ads_analytics` object, nullable
      - `enabled` boolean
    - `integrations_view` object, nullable
      - `enabled` boolean
    - `integrations_create` object, nullable
      - `enabled` boolean
    - `integrations_update` object, nullable
      - `enabled` boolean
    - `integrations_delete` object, nullable
      - `enabled` boolean
    - `player_settings_view` object, nullable
      - `enabled` boolean
    - `player_settings_update` object, nullable
      - `enabled` boolean
    - `playlists_view` object, nullable
      - `enabled` boolean
    - `playlists_create` object, nullable
      - `enabled` boolean
    - `playlists_update` object, nullable
      - `enabled` boolean
    - `playlists_delete` object, nullable
      - `enabled` boolean
    - `project_members_view` object, nullable
      - `enabled` boolean
    - `project_members_create` object, nullable
      - `enabled` boolean
    - `project_members_delete` object, nullable
      - `enabled` boolean
    - `ads_view` object, nullable
      - `enabled` boolean
    - `ads_create` object, nullable
      - `enabled` boolean
    - `ads_update` object, nullable
      - `enabled` boolean
    - `ads_delete` object, nullable
      - `enabled` boolean
    - `organization_voices_view` object, nullable
      - `enabled` boolean
    - `organization_voices_create` object, nullable
      - `enabled` boolean
    - `organization_voices_update` object, nullable
      - `enabled` boolean
    - `organization_voices_delete` object, nullable
      - `enabled` boolean
    - `organization_voices_clone` object, nullable
      - `enabled` boolean
  - `members_count` integer
  - `created` string: Time at which the object was created (ISO 8601)
  - `updated` string: Time at which the object was updated (ISO 8601)

## Changes

- **2026-11-03** `994b9853e685`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/beyondwords/apis/beyondwords-rest-api/changes/roles/:id/put.md)

---

[API](https://skmtc.dev/beyondwords/apis/beyondwords-rest-api.md) - [All operations](https://skmtc.dev/beyondwords/apis/beyondwords-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/beyondwords/apis/beyondwords-rest-api/revisions/994b9853e685?raw)