---
title: "Update a role"
method: PATCH
path: "/roles/{role_id}"
tags: ["Roles"]
---

# Update a role

`PATCH /roles/{role_id}`

## Request

- Base URL: `https://api.sandbox.monite.com/v1`
- URL: `https://api.sandbox.monite.com/v1/roles/{role_id}`
- Auth: HTTP bearer

Change the specified fields with the provided values.

## Path parameters

- `role_id` string, required

## Headers

- `x-monite-version` string, required
- `x-monite-entity-id` string, required

## Request body

- object
  - `name` string: Role name
  - `permissions` BizObjectsSchemaInput
    - `objects` RootSchemaInput[]: List of objects
      - union
        - object
          - `object_type` 'accounting_tax_rate', required: Discriminator value: accounting_tax_rate
          - `actions` ActionSchema[]: List of actions
            - `action_name` 'create' | 'read' | 'update' | 'delete'
            - `permission` 'allowed' | 'allowed_for_own' | 'not_allowed'
        - object
          - `object_type` 'approval_policy', required: Discriminator value: approval_policy
          - `actions` ActionSchema[]: List of actions
            - `action_name` 'create' | 'read' | 'update' | 'delete'
            - `permission` 'allowed' | 'allowed_for_own' | 'not_allowed'
        - object
          - `object_type` 'approval_request', required: Discriminator value: approval_request
          - `actions` ActionSchema[]: List of actions
            - `action_name` 'create' | 'read' | 'update' | 'delete'
            - `permission` 'allowed' | 'allowed_for_own' | 'not_allowed'
        - object
          - `object_type` 'comment', required: Discriminator value: comment
          - `actions` ActionSchema[]: List of actions
            - `action_name` 'create' | 'read' | 'update' | 'delete'
            - `permission` 'allowed' | 'allowed_for_own' | 'not_allowed'
        - object
          - `object_type` 'cost_center', required: Discriminator value: cost_center
          - `actions` ActionSchema[]: List of actions
            - `action_name` 'create' | 'read' | 'update' | 'delete'
            - `permission` 'allowed' | 'allowed_for_own' | 'not_allowed'
        - object
          - `object_type` 'counterpart', required: Discriminator value: counterpart
          - `actions` ActionSchema[]: List of actions
            - `action_name` 'create' | 'read' | 'update' | 'delete'
            - `permission` 'allowed' | 'allowed_for_own' | 'not_allowed'
        - object
          - `object_type` 'counterpart_vat_id', required: Discriminator value: counterpart_vat_id
          - `actions` ActionSchema[]: List of actions
            - `action_name` 'create' | 'read' | 'update' | 'delete'
            - `permission` 'allowed' | 'allowed_for_own' | 'not_allowed'
        - object
          - `object_type` 'delivery_note', required: Discriminator value: delivery_note
          - `actions` ActionSchema[]: List of actions
            - `action_name` 'create' | 'read' | 'update' | 'delete'
            - `permission` 'allowed' | 'allowed_for_own' | 'not_allowed'
        - object
          - `object_type` 'entity', required: Discriminator value: entity
          - `actions` ActionSchema[]: List of actions
            - `action_name` 'create' | 'read' | 'update' | 'delete'
            - `permission` 'allowed' | 'allowed_for_own' | 'not_allowed'
        - object
          - `object_type` 'entity_bank_account', required: Discriminator value: entity_bank_account
          - `actions` ActionSchema[]: List of actions
            - `action_name` 'create' | 'read' | 'update' | 'delete'
            - `permission` 'allowed' | 'allowed_for_own' | 'not_allowed'
        - object
          - `object_type` 'entity_user', required: Discriminator value: entity_user
          - `actions` ActionSchema[]: List of actions
            - `action_name` 'create' | 'read' | 'update' | 'delete'
            - `permission` 'allowed' | 'allowed_for_own' | 'not_allowed'
        - object
          - `object_type` 'entity_vat_ids', required: Discriminator value: entity_vat_ids
          - `actions` ActionSchema[]: List of actions
            - `action_name` 'create' | 'read' | 'update' | 'delete'
            - `permission` 'allowed' | 'allowed_for_own' | 'not_allowed'
        - object
          - `object_type` 'export', required: Discriminator value: export
          - `actions` ActionSchema[]: List of actions
            - `action_name` 'create' | 'read' | 'update' | 'delete'
            - `permission` 'allowed' | 'allowed_for_own' | 'not_allowed'
        - object
          - `object_type` 'ledger_account', required: Discriminator value: ledger_account
          - `actions` ActionSchema[]: List of actions
            - `action_name` 'create' | 'read' | 'update' | 'delete'
            - `permission` 'allowed' | 'allowed_for_own' | 'not_allowed'
        - object
          - `object_type` 'mailbox', required: Discriminator value: mailbox
          - `actions` ActionSchema[]: List of actions
            - `action_name` 'create' | 'read' | 'update' | 'delete'
            - `permission` 'allowed' | 'allowed_for_own' | 'not_allowed'
        - object
          - `object_type` 'ocr_task', required: Discriminator value: ocr_task
          - `actions` ActionSchema[]: List of actions
            - `action_name` 'create' | 'read' | 'update' | 'delete'
            - `permission` 'allowed' | 'allowed_for_own' | 'not_allowed'
        - object
          - `object_type` 'onboarding', required: Discriminator value: onboarding
          - `actions` ActionSchema[]: List of actions
            - `action_name` 'create' | 'read' | 'update' | 'delete'
            - `permission` 'allowed' | 'allowed_for_own' | 'not_allowed'
        - object
          - `object_type` 'overdue_reminder', required: Discriminator value: overdue_reminder
          - `actions` ActionSchema[]: List of actions
            - `action_name` 'create' | 'read' | 'update' | 'delete'
            - `permission` 'allowed' | 'allowed_for_own' | 'not_allowed'
        - object
          - `object_type` 'payable', required: Discriminator value: payable
          - `actions` PayableActionSchema[]: List of actions
            - `action_name` 'create' | 'read' | 'update' | 'delete' | 'pay' | 'approve' | 'cancel' | 'submit' | 'create_from_mail' | 'reopen'
            - `permission` 'allowed' | 'allowed_for_own' | 'not_allowed'
        - object
          - `object_type` 'payables_purchase_order', required: Discriminator value: payables_purchase_order
          - `actions` ActionSchema[]: List of actions
            - `action_name` 'create' | 'read' | 'update' | 'delete'
            - `permission` 'allowed' | 'allowed_for_own' | 'not_allowed'
        - object
          - `object_type` 'payment_record', required: Discriminator value: payment_record
          - `actions` ActionSchema[]: List of actions
            - `action_name` 'create' | 'read' | 'update' | 'delete'
            - `permission` 'allowed' | 'allowed_for_own' | 'not_allowed'
        - object
          - `object_type` 'payment_reminder', required: Discriminator value: payment_reminder
          - `actions` ActionSchema[]: List of actions
            - `action_name` 'create' | 'read' | 'update' | 'delete'
            - `permission` 'allowed' | 'allowed_for_own' | 'not_allowed'
        - object
          - `object_type` 'person', required: Discriminator value: person
          - `actions` ActionSchema[]: List of actions
            - `action_name` 'create' | 'read' | 'update' | 'delete'
            - `permission` 'allowed' | 'allowed_for_own' | 'not_allowed'
        - object
          - `object_type` 'product', required: Discriminator value: product
          - `actions` ActionSchema[]: List of actions
            - `action_name` 'create' | 'read' | 'update' | 'delete'
            - `permission` 'allowed' | 'allowed_for_own' | 'not_allowed'
        - object
          - `object_type` 'project', required: Discriminator value: project
          - `actions` ActionSchema[]: List of actions
            - `action_name` 'create' | 'read' | 'update' | 'delete'
            - `permission` 'allowed' | 'allowed_for_own' | 'not_allowed'
        - object
          - `object_type` 'receipt', required: Discriminator value: receipt
          - `actions` ActionSchema[]: List of actions
            - `action_name` 'create' | 'read' | 'update' | 'delete'
            - `permission` 'allowed' | 'allowed_for_own' | 'not_allowed'
        - object
          - `object_type` 'receivable', required: Discriminator value: receivable
          - `actions` ActionSchema[]: List of actions
            - `action_name` 'create' | 'read' | 'update' | 'delete'
            - `permission` 'allowed' | 'allowed_for_own' | 'not_allowed'
        - object
          - `object_type` 'reconciliation', required: Discriminator value: reconciliation
          - `actions` ActionSchema[]: List of actions
            - `action_name` 'create' | 'read' | 'update' | 'delete'
            - `permission` 'allowed' | 'allowed_for_own' | 'not_allowed'
        - object
          - `object_type` 'role', required: Discriminator value: role
          - `actions` ActionSchema[]: List of actions
            - `action_name` 'create' | 'read' | 'update' | 'delete'
            - `permission` 'allowed' | 'allowed_for_own' | 'not_allowed'
        - object
          - `object_type` 'tag', required: Discriminator value: tag
          - `actions` ActionSchema[]: List of actions
            - `action_name` 'create' | 'read' | 'update' | 'delete'
            - `permission` 'allowed' | 'allowed_for_own' | 'not_allowed'
        - object
          - `object_type` 'todo_task', required: Discriminator value: todo_task
          - `actions` ActionSchema[]: List of actions
            - `action_name` 'create' | 'read' | 'update' | 'delete'
            - `permission` 'allowed' | 'allowed_for_own' | 'not_allowed'
        - object
          - `object_type` 'todo_task_mute', required: Discriminator value: todo_task_mute
          - `actions` ActionSchema[]: List of actions
            - `action_name` 'create' | 'read' | 'update' | 'delete'
            - `permission` 'allowed' | 'allowed_for_own' | 'not_allowed'
        - object
          - `object_type` 'transaction', required: Discriminator value: transaction
          - `actions` ActionSchema[]: List of actions
            - `action_name` 'create' | 'read' | 'update' | 'delete'
            - `permission` 'allowed' | 'allowed_for_own' | 'not_allowed'
        - object
          - `object_type` 'workflow', required: Discriminator value: workflow
          - `actions` ActionSchema[]: List of actions
            - `action_name` 'create' | 'read' | 'update' | 'delete'
            - `permission` 'allowed' | 'allowed_for_own' | 'not_allowed'

## Response `200`

Successful Response

- RoleResponse
  - `id` string, uuid, required: UUID role ID
  - `created_at` string, date-time, required: UTC datetime
  - `updated_at` string, date-time, required: UTC datetime
  - `name` string, required: Role name
  - `permissions` BizObjectsSchemaOutput, required
    - `objects` RootSchemaOutput[]: List of objects
      - union
        - object
          - `object_type` 'accounting_tax_rate', required: Discriminator value: accounting_tax_rate
          - `actions` ActionSchema[]: List of actions
            - `action_name` 'create' | 'read' | 'update' | 'delete'
            - `permission` 'allowed' | 'allowed_for_own' | 'not_allowed'
        - object
          - `object_type` 'approval_policy', required: Discriminator value: approval_policy
          - `actions` ActionSchema[]: List of actions
            - `action_name` 'create' | 'read' | 'update' | 'delete'
            - `permission` 'allowed' | 'allowed_for_own' | 'not_allowed'
        - object
          - `object_type` 'approval_request', required: Discriminator value: approval_request
          - `actions` ActionSchema[]: List of actions
            - `action_name` 'create' | 'read' | 'update' | 'delete'
            - `permission` 'allowed' | 'allowed_for_own' | 'not_allowed'
        - object
          - `object_type` 'comment', required: Discriminator value: comment
          - `actions` ActionSchema[]: List of actions
            - `action_name` 'create' | 'read' | 'update' | 'delete'
            - `permission` 'allowed' | 'allowed_for_own' | 'not_allowed'
        - object
          - `object_type` 'cost_center', required: Discriminator value: cost_center
          - `actions` ActionSchema[]: List of actions
            - `action_name` 'create' | 'read' | 'update' | 'delete'
            - `permission` 'allowed' | 'allowed_for_own' | 'not_allowed'
        - object
          - `object_type` 'counterpart', required: Discriminator value: counterpart
          - `actions` ActionSchema[]: List of actions
            - `action_name` 'create' | 'read' | 'update' | 'delete'
            - `permission` 'allowed' | 'allowed_for_own' | 'not_allowed'
        - object
          - `object_type` 'counterpart_vat_id', required: Discriminator value: counterpart_vat_id
          - `actions` ActionSchema[]: List of actions
            - `action_name` 'create' | 'read' | 'update' | 'delete'
            - `permission` 'allowed' | 'allowed_for_own' | 'not_allowed'
        - object
          - `object_type` 'delivery_note', required: Discriminator value: delivery_note
          - `actions` ActionSchema[]: List of actions
            - `action_name` 'create' | 'read' | 'update' | 'delete'
            - `permission` 'allowed' | 'allowed_for_own' | 'not_allowed'
        - object
          - `object_type` 'entity', required: Discriminator value: entity
          - `actions` ActionSchema[]: List of actions
            - `action_name` 'create' | 'read' | 'update' | 'delete'
            - `permission` 'allowed' | 'allowed_for_own' | 'not_allowed'
        - object
          - `object_type` 'entity_bank_account', required: Discriminator value: entity_bank_account
          - `actions` ActionSchema[]: List of actions
            - `action_name` 'create' | 'read' | 'update' | 'delete'
            - `permission` 'allowed' | 'allowed_for_own' | 'not_allowed'
        - object
          - `object_type` 'entity_user', required: Discriminator value: entity_user
          - `actions` ActionSchema[]: List of actions
            - `action_name` 'create' | 'read' | 'update' | 'delete'
            - `permission` 'allowed' | 'allowed_for_own' | 'not_allowed'
        - object
          - `object_type` 'entity_vat_ids', required: Discriminator value: entity_vat_ids
          - `actions` ActionSchema[]: List of actions
            - `action_name` 'create' | 'read' | 'update' | 'delete'
            - `permission` 'allowed' | 'allowed_for_own' | 'not_allowed'
        - object
          - `object_type` 'export', required: Discriminator value: export
          - `actions` ActionSchema[]: List of actions
            - `action_name` 'create' | 'read' | 'update' | 'delete'
            - `permission` 'allowed' | 'allowed_for_own' | 'not_allowed'
        - object
          - `object_type` 'ledger_account', required: Discriminator value: ledger_account
          - `actions` ActionSchema[]: List of actions
            - `action_name` 'create' | 'read' | 'update' | 'delete'
            - `permission` 'allowed' | 'allowed_for_own' | 'not_allowed'
        - object
          - `object_type` 'mailbox', required: Discriminator value: mailbox
          - `actions` ActionSchema[]: List of actions
            - `action_name` 'create' | 'read' | 'update' | 'delete'
            - `permission` 'allowed' | 'allowed_for_own' | 'not_allowed'
        - object
          - `object_type` 'ocr_task', required: Discriminator value: ocr_task
          - `actions` ActionSchema[]: List of actions
            - `action_name` 'create' | 'read' | 'update' | 'delete'
            - `permission` 'allowed' | 'allowed_for_own' | 'not_allowed'
        - object
          - `object_type` 'onboarding', required: Discriminator value: onboarding
          - `actions` ActionSchema[]: List of actions
            - `action_name` 'create' | 'read' | 'update' | 'delete'
            - `permission` 'allowed' | 'allowed_for_own' | 'not_allowed'
        - object
          - `object_type` 'overdue_reminder', required: Discriminator value: overdue_reminder
          - `actions` ActionSchema[]: List of actions
            - `action_name` 'create' | 'read' | 'update' | 'delete'
            - `permission` 'allowed' | 'allowed_for_own' | 'not_allowed'
        - object
          - `object_type` 'payable', required: Discriminator value: payable
          - `actions` PayableActionSchema[]: List of actions
            - `action_name` 'create' | 'read' | 'update' | 'delete' | 'pay' | 'approve' | 'cancel' | 'submit' | 'create_from_mail' | 'reopen'
            - `permission` 'allowed' | 'allowed_for_own' | 'not_allowed'
        - object
          - `object_type` 'payables_purchase_order', required: Discriminator value: payables_purchase_order
          - `actions` ActionSchema[]: List of actions
            - `action_name` 'create' | 'read' | 'update' | 'delete'
            - `permission` 'allowed' | 'allowed_for_own' | 'not_allowed'
        - object
          - `object_type` 'payment_record', required: Discriminator value: payment_record
          - `actions` ActionSchema[]: List of actions
            - `action_name` 'create' | 'read' | 'update' | 'delete'
            - `permission` 'allowed' | 'allowed_for_own' | 'not_allowed'
        - object
          - `object_type` 'payment_reminder', required: Discriminator value: payment_reminder
          - `actions` ActionSchema[]: List of actions
            - `action_name` 'create' | 'read' | 'update' | 'delete'
            - `permission` 'allowed' | 'allowed_for_own' | 'not_allowed'
        - object
          - `object_type` 'person', required: Discriminator value: person
          - `actions` ActionSchema[]: List of actions
            - `action_name` 'create' | 'read' | 'update' | 'delete'
            - `permission` 'allowed' | 'allowed_for_own' | 'not_allowed'
        - object
          - `object_type` 'product', required: Discriminator value: product
          - `actions` ActionSchema[]: List of actions
            - `action_name` 'create' | 'read' | 'update' | 'delete'
            - `permission` 'allowed' | 'allowed_for_own' | 'not_allowed'
        - object
          - `object_type` 'project', required: Discriminator value: project
          - `actions` ActionSchema[]: List of actions
            - `action_name` 'create' | 'read' | 'update' | 'delete'
            - `permission` 'allowed' | 'allowed_for_own' | 'not_allowed'
        - object
          - `object_type` 'receipt', required: Discriminator value: receipt
          - `actions` ActionSchema[]: List of actions
            - `action_name` 'create' | 'read' | 'update' | 'delete'
            - `permission` 'allowed' | 'allowed_for_own' | 'not_allowed'
        - object
          - `object_type` 'receivable', required: Discriminator value: receivable
          - `actions` ActionSchema[]: List of actions
            - `action_name` 'create' | 'read' | 'update' | 'delete'
            - `permission` 'allowed' | 'allowed_for_own' | 'not_allowed'
        - object
          - `object_type` 'reconciliation', required: Discriminator value: reconciliation
          - `actions` ActionSchema[]: List of actions
            - `action_name` 'create' | 'read' | 'update' | 'delete'
            - `permission` 'allowed' | 'allowed_for_own' | 'not_allowed'
        - object
          - `object_type` 'role', required: Discriminator value: role
          - `actions` ActionSchema[]: List of actions
            - `action_name` 'create' | 'read' | 'update' | 'delete'
            - `permission` 'allowed' | 'allowed_for_own' | 'not_allowed'
        - object
          - `object_type` 'tag', required: Discriminator value: tag
          - `actions` ActionSchema[]: List of actions
            - `action_name` 'create' | 'read' | 'update' | 'delete'
            - `permission` 'allowed' | 'allowed_for_own' | 'not_allowed'
        - object
          - `object_type` 'todo_task', required: Discriminator value: todo_task
          - `actions` ActionSchema[]: List of actions
            - `action_name` 'create' | 'read' | 'update' | 'delete'
            - `permission` 'allowed' | 'allowed_for_own' | 'not_allowed'
        - object
          - `object_type` 'todo_task_mute', required: Discriminator value: todo_task_mute
          - `actions` ActionSchema[]: List of actions
            - `action_name` 'create' | 'read' | 'update' | 'delete'
            - `permission` 'allowed' | 'allowed_for_own' | 'not_allowed'
        - object
          - `object_type` 'transaction', required: Discriminator value: transaction
          - `actions` ActionSchema[]: List of actions
            - `action_name` 'create' | 'read' | 'update' | 'delete'
            - `permission` 'allowed' | 'allowed_for_own' | 'not_allowed'
        - object
          - `object_type` 'workflow', required: Discriminator value: workflow
          - `actions` ActionSchema[]: List of actions
            - `action_name` 'create' | 'read' | 'update' | 'delete'
            - `permission` 'allowed' | 'allowed_for_own' | 'not_allowed'
  - `status` 'active' | 'deleted', required

## Other responses

- `400`: Bad Request
- `422`: Validation Error
- `500`: Internal Server Error

---

[API](https://skmtc.dev/monite/apis/monite-3.md) - [All operations](https://skmtc.dev/monite/apis/monite-3/llms.txt) - [OpenAPI document](https://skmtc.dev/monite/apis/monite-3/revisions/c13be6f83ce9?raw)