---
title: "Editando funções"
method: PATCH
path: "/api/v4/roles"
---

# Editando funções

`PATCH /api/v4/roles`

Este método permite a edição das funções de usuários.

## Headers

- `Content-Type` string

## Request body

- object
  - `RAW_BODY` object[]
    - `id` integer, required — ID da função
    - `name` string — Nome da função
    - `rights` object
      - `leads` object — Objeto de direitos de acesso a leads
        - `view` 'A' | 'G' | 'M' | 'D'
        - `edit` 'A' | 'G' | 'M' | 'D'
        - `add` 'A' | 'G' | 'M' | 'D'
        - `delete` 'A' | 'G' | 'M' | 'D'
        - `export` 'A' | 'G' | 'M' | 'D'
      - `contacts` object — Objeto de direitos de acesso a contatos
        - `view` 'A' | 'G' | 'M' | 'D'
        - `edit` 'A' | 'G' | 'M' | 'D'
        - `add` 'A' | 'G' | 'M' | 'D'
        - `delete` 'A' | 'G' | 'M' | 'D'
        - `export` 'A' | 'G' | 'M' | 'D'
      - `companies` object — Objeto de direitos de acesso a empresas
        - `view` 'A' | 'G' | 'M' | 'D'
        - `edit` 'A' | 'G' | 'M' | 'D'
        - `add` 'A' | 'G' | 'M' | 'D'
        - `delete` 'A' | 'G' | 'M' | 'D'
        - `export` 'A' | 'G' | 'M' | 'D'
      - `tasks` object — Objeto de direitos de acesso a tarefas
        - `view` 'A' | 'G' | 'M' | 'D'
        - `edit` 'A' | 'G' | 'M' | 'D'
        - `add` 'A' | 'G' | 'M' | 'D'
        - `delete` 'A' | 'G' | 'M' | 'D'
        - `export` 'A' | 'G' | 'M' | 'D'
      - `status_rights` string, json — Um array de objetos que definem os direitos de estágio. É nulo por padrão.
      - `mail_access` boolean — Define se a funcionalidade de E-mail é permitida para o usuário. É falso por padrão.
      - `catalog_access` boolean — Define se a funcionalidade de Listas é permitida para o usuário. É falso por padrão.

## Response `202`

202

## Other responses

- `400` — 400
- `401` — 401
- `403` — 403

---

[API](https://skmtc.net/kommo/apis/referencias-de-api-da-kommo.md) · [All operations](https://skmtc.net/kommo/apis/referencias-de-api-da-kommo/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kommo/referencias-de-api-da-kommo/versions/98fdf05c2f5b/schema)