POST/api/roles

Criar grupo de usuários

Criar grupo de usuários

Access Token

Para realizar requisições GET, POST, PUT, DELETE e PATCH nos endpoints da API você precisa de uma chave de autorização. Chamamos essa chave de accessToken.

Para ter acesso ao accessToken, é necessário que o usuário master da licença efetue a liberação deste pela interface do ImageMais Clinic. O accessToken tem validade de 1 hora.

Headers

AuthorizationOBRIGATÓRIO
Tipo:string
Token de autenticação no formato Bearer {accessToken}
Content-TypeOBRIGATÓRIO
Tipo:application/json
Tipo de conteúdo (application/json)

Parâmetros

nameOBRIGATÓRIO
Tipo:string
Nome do grupo de usuários
permissionsIdsOBRIGATÓRIO
Tipo:array
Array de IDs das permissões que serão atribuídas ao grupo

Request URL

https://api-dev.imagemais.com/api/roles
curl -X 'POST' \
  'https://api-dev.imagemais.com/api/roles' \
  -H 'accept: */*' \
  -H 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOjExLCJhY2NvdW50SWQiOjEsImlhdCI6MTc2NTk5MzA2MywiZXhwIjoxNzY1OTk2NjYzLCJhdWQiOiJodHRwczovL2FwaS1kZXYuaW1hZ2VtYWlzLmNvbSIsImlzcyI6Imh0dHBzOi8vYXBwLWRldi5pbWFnZW1haXMuY29tIn0.oLEB2Ba73uOIK7SpDElgTOPSDwk-Y99hwrbWaPyXc5A' \
  -H 'Content-Type: application/json' \
  -d '{
  "name": "superMegan",
  "permissionsIds": [
    1,2,3
  ]
}'
{
  "name": "superMegan",
  "permissionsIds": [
  ...
{
  "name": "superMegan",
  "permissionsIds": [
    1,
    2,
    3
  ]
}

Respostas

{
  "id": 13,
  "name": "superMegan",
  ...
{
  "id": 13,
  "name": "superMegan",
  "accountId": 1,
  "createdAt": "2025-12-17T18:21:44.281Z",
  "updatedAt": "2025-12-17T18:21:44.281Z",
  "deletedAt": null
}
{
  "message": [
    "name should not be empty",
  ...
{
  "message": [
    "name should not be empty",
    "name must be a string"
  ]
}
{
  "message": [
    "É necessário pelo menos 1 procedimento",
  ...
{
  "message": [
    "É necessário pelo menos 1 procedimento",
    "permissionsIds must be an array"
  ]
}
{
  "statusCode": 404,
  "message": "Grupo de Usuário já existe"
  ...
{
  "statusCode": 404,
  "message": "Grupo de Usuário já existe"
}
{
  "statusCode": 401,
  "message": "invalid token"
  ...
{
  "statusCode": 401,
  "message": "invalid token"
}
{
  "statusCode": 401,
  "message": "jwt expired"
  ...
{
  "statusCode": 401,
  "message": "jwt expired"
}
{
  "statusCode": 500,
  "message": "Internal server error"
  ...
{
  "statusCode": 500,
  "message": "Internal server error"
}