Skip to main content

​
GET /v1beta1/policies/

Retrieve detailed information about a specific policy using its unique identifier.

​
Path Parameters

​
id
string
required
Unique identifier (UUID) of the policy to retrieve.

​
Response

​
policy
object
The requested policy object.
​
id
string
Unique identifier for the policy.
​
role_id
string
ID of the role assigned by this policy.
​
resource
string
Resource identifier in the format namespace:resource_id (e.g., app/organization:123).
​
principal
string
Principal identifier in the format namespace:principal_id (e.g., app/user:456).
​
metadata
object
Additional metadata associated with the policy.
​
created_at
timestamp
Timestamp when the policy was created.
​
updated_at
timestamp
Timestamp when the policy was last updated.
curl -X GET 'https://api.frontier.example.com/v1beta1/policies/550e8400-e29b-41d4-a716-446655440000' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN'

​
Response Example

{
  "policy": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "role_id": "admin-role-id",
    "resource": "app/organization:org-123",
    "principal": "app/user:user-456",
    "metadata": {
      "description": "Admin access to organization",
      "granted_by": "system-admin"
    },
    "created_at": "2024-01-15T10:30:00Z",
    "updated_at": "2024-01-15T10:30:00Z"
  }
}

​
Error Responses

​
error
object
​
code
string
Error code. Possible values:
  • not_found - Policy not found (invalid ID or policy doesn’t exist)
  • internal - Internal server error
​
message
string
Human-readable error message.

​
Error Example

{
  "error": {
    "code": "not_found",
    "message": "policy not found"
  }
}

​
Notes

  • The policy ID must be a valid UUID
  • Returns a 404 error if the policy doesn’t exist or the ID is invalid
  • Use this endpoint to retrieve full policy details including all metadata

Build docs developers (and LLMs) love

Get started for freeTalk to us