Atualizar acesso

Endpoint: PUT/PATCH /user/{user_id}/legacy/accesses/{id}/

Autenticação: JWT obrigatório

O único campo modificável em um registro de acesso é group — ou seja, quais permissões o usuário tem no vendedor ou na conta vinculada. Para alterar o vendedor ou a conta em si, remova este registro e crie outro.

Pré-requisitos

O registro de acesso precisa existir. Crie um via POST /user/{user_id}/legacy/accesses/.
O novo grupo precisa existir.
Quem faz a chamada precisa ser superusuário ou possuir a permissão auth.manage_accesses.

Parâmetros de rota

integer

required

Identificador do usuário dono do acesso.

integer

required

Identificador do registro de acesso.

Corpo da requisição

integer

required

Identificador do grupo a ser atribuído.

Resposta

Retorna o acesso atualizado (formato resumido).

integer

Novo identificador de grupo.

string

{
  "id": 12,
  "group": 5,
  "updated_at": "2026-05-14T09:00:00.000000Z"
}

Erros

Status	Quando
`400`	`group` ausente ou inexistente (“Group not found.”).
`401`	Token ausente ou inválido.
`403`	Quem chama não possui `auth.manage_accesses` e não é superusuário.
`404`	Nenhum acesso encontrado para o par `user_id` + `id`.

Exemplos

curl -X PATCH https://api.dlpay.cloud/user/42/legacy/accesses/12/ \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"group": 5}'

import requests

response = requests.patch(
    "https://api.dlpay.cloud/user/42/legacy/accesses/12/",
    headers={"Authorization": f"Bearer {access_token}"},
    json={"group": 5},
)
access = response.json()

const response = await fetch(
  "https://api.dlpay.cloud/user/42/legacy/accesses/12/",
  {
    method: "PATCH",
    headers: {
      Authorization: `Bearer ${accessToken}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({ group: 5 }),
  },
);
const access = await response.json();

Início

Autenticação e usuários

Vendedores

Vendas

Planos

Contas unificadas

Eventos

Assinaturas

Contas virtuais

Integrações do vendedor

Pré-requisitos

Parâmetros de rota

Corpo da requisição

Resposta

Erros

Exemplos

​Pré-requisitos

​Parâmetros de rota

​Corpo da requisição

​Resposta

​Erros

​Exemplos

Pré-requisitos

Parâmetros de rota

Corpo da requisição

Resposta

Erros

Exemplos