➕ Criar Perfil

POST

/v1/profiles

📖 Descrição

Cria um novo perfil de permissão vinculado à empresa.

🎯 Detalhes e Regras de Uso

Os campos obrigatórios são:

name — nome para identificação do perfil, deve ser único

fields — lista de restrições do perfil

🔐 Restrições do Perfil

Restrições são um array, onde cada item deve conter:

filter: nome do filtro aplicado (único no array).

values: array com os nomes dos recortes permitidos (únicos para cada filtro).

🆔 UUID de Retorno

O endpoint retorna o UUID do perfil criado.
Esse identificador deve ser utilizado para atualizar ou excluir o perfil posteriormente.

Exemplos de uso:

Requisição

Authorization

Forneça seu token bearer no cabeçalho

Authorization

ao fazer requisições para recursos protegidos.

Exemplo:

Authorization: Bearer ********************

Parâmetros Bodyapplication/jsonNecessário

Exemplo

{
    "name": "string",
    "fields": [
        {
            "filter": "string",
            "values": [
                "string"
            ]
        }
    ]
}

Exemplos de Requisição

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://scenic-tokyo-3bje4ahyb4rd.on-vapor.com/api/v1/profiles' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name": "string",
    "fields": [
        {
            "filter": "string",
            "values": [
                "string"
            ]
        }
    ]
}'

Respostas

🟢200Sucesso

application/json

Body

Exemplo

{
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "name": "string",
    "fields": [
        {
            "filter": "string",
            "values": [
                "string"
            ]
        }
    ],
    "created_at": "2019-08-24T14:15:22Z",
    "updated_at": "2019-08-24T14:15:22Z"
}