Criar grupo

Endpoint: POST /user/groups/

Autenticação: JWT obrigatório

Cria um novo grupo. O campo permissions aceita uma lista de identificadores de permissão e é restrito a permissões que não pertencem aos módulos internos da plataforma — permissões dos módulos internos auth, admin, contenttypes e sessions são rejeitadas. Use GET /user/groups/permissions/ para descobrir os identificadores válidos.

Pré-requisitos

Quem faz a chamada precisa ser superusuário ou possuir a permissão auth.manage_groups.

Corpo da requisição

string

required

Nome do grupo (deve ser único).

integer[]

Lista de identificadores de permissão a anexar. Valor padrão: lista vazia. Identificadores dos módulos auth, admin, contenttypes ou sessions não são selecionáveis.

Resposta

201 Created com o novo grupo.

integer

string

integer[]

Lista de identificadores de permissão anexados.

{
  "id": 7,
  "name": "Read-Only Analyst",
  "permissions": [104, 109]
}

Erros

Status	Quando
`400`	`name` ausente ou duplicado, ou algum item de `permissions` não é permitido / não existe.
`401`	Token ausente ou inválido.
`403`	Quem chama não possui `auth.manage_groups`.

Exemplos

curl -X POST https://api.dlpay.cloud/user/groups/ \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name": "Read-Only Analyst", "permissions": [104, 109]}'

import requests

response = requests.post(
    "https://api.dlpay.cloud/user/groups/",
    headers={"Authorization": f"Bearer {access_token}"},
    json={"name": "Read-Only Analyst", "permissions": [104, 109]},
)
group = response.json()

const response = await fetch("https://api.dlpay.cloud/user/groups/", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${accessToken}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    name: "Read-Only Analyst",
    permissions: [104, 109],
  }),
});
const group = 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

Corpo da requisição

Resposta

Erros

Exemplos

​Pré-requisitos

​Corpo da requisição

​Resposta

​Erros

​Exemplos

Pré-requisitos

Corpo da requisição

Resposta

Erros

Exemplos