GET/api/roles

Buscar todos os grupos de usuários

Buscar todos os grupos 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

limitOPCIONAL
Tipo:number
Limite de grupos de usuários a serem retornados
offsetOPCIONAL
Tipo:number
Offset de grupos de usuários a serem retornados
nameOPCIONAL
Tipo:string
Busca por nome do grupo de usuários

Request URL

https://api-dev.imagemais.com/api/roles?limit=50&offset=0

Respostas

[
  {
    "id": 1,
  ...
[
  {
    "id": 1,
    "name": "ADMIN",
    "accountId": 1,
    "createdAt": "2025-04-03T14:18:42.788Z",
    "updatedAt": "2025-12-16T23:04:10.207Z",
    "deletedAt": null,
    "users": [
      {
        "name": "João Silva"
      },
      {
        "name": "Maria Santos"
      },
      {
        "name": "Pedro Oliveira"
      },
      {
        "name": "Ana Costa"
      },
      {
        "name": "Carlos Ferreira"
      },
      {
        "name": "Juliana Alves"
      },
      {
        "name": "Roberto Lima"
      },
      {
        "name": "Fernanda Souza"
      },
      {
        "name": "Ricardo Martins"
      },
      {
        "name": "Patricia Rocha"
      }
    ],
    "_count": {
      "permissions": 60,
      "users": 10
    }
  },
  {
    "id": 2,
    "name": "CALL CENTER / RECEPÇÃO",
    "accountId": 1,
    "createdAt": "2025-04-03T17:25:35.128Z",
    "updatedAt": "2025-10-27T15:58:43.626Z",
    "deletedAt": null,
    "users": [
      {
        "name": "Amanda Pereira"
      },
      {
        "name": "Bruno Rodrigues"
      },
      {
        "name": "Camila Barbosa"
      },
      {
        "name": "Diego Carvalho"
      },
      {
        "name": "Eduarda Gomes"
      },
      {
        "name": "Felipe Araújo"
      },
      {
        "name": "Gabriela Ribeiro"
      },
      {
        "name": "Henrique Dias"
      },
      {
        "name": "Isabela Moreira"
      },
      {
        "name": "Lucas Nunes"
      }
    ],
    "_count": {
      "permissions": 15,
      "users": 10
    }
  }
]
{
  "message": "limit must not be greater than 100",
  "error": "Bad Request"
  ...
{
  "message": "limit must not be greater than 100",
  "error": "Bad Request"
}
{
  "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"
}