Skip to main content

​
GET /api/permissions/

Retrieves detailed information about a specific permission using its unique identifier.

​
Authentication

This endpoint requires authentication with a valid Bearer token.

​
Path Parameters

​
id
uuid
required
The unique identifier of the permission to retrieve

​
Response

​
id
uuid
Unique identifier of the permission
​
name
string
The name of the permission
​
description
string
Description of the permission
​
status
string
Current status of the permission (e.g., “ACTIVE”, “INACTIVE”)

​
Status Codes

  • 200 OK - Permission found and returned successfully
  • 404 Not Found - Permission with the specified ID not found

​
Example Request

curl -X GET https://api.example.com/api/permissions/550e8400-e29b-41d4-a716-446655440000 \
  -H "Authorization: Bearer YOUR_TOKEN"

​
Example Response

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "users:read",
  "description": "Permission to read user data",
  "status": "ACTIVE"
}

​
Error Response

{
  "timestamp": "2026-03-04T10:30:00Z",
  "status": 404,
  "error": "Not Found",
  "message": "Permiso no encontrado",
  "path": "/api/permissions/550e8400-e29b-41d4-a716-446655440000"
}

Build docs developers (and LLMs) love

Get started for freeTalk to us