Skip to main content

​
Get policy details

Retrieve detailed information about a specific policy, including its full configuration.

​
Endpoint

GET /policies/{policy_id}

​
Authentication

Requires tenant authentication via the X-Tenant-ID header or similar tenant identification mechanism.

​
Path parameters

​
policy_id
string
required
UUID of the policy to retrieve

​
Response

​
id
string
Unique identifier (UUID) of the policy
​
name
string
Policy name
​
policy_type
string
Policy type name
​
configuration
object
Policy configuration object containing type-specific settings
​
endpoint_id
string
UUID of the endpoint this policy is attached to
​
created_at
string
Creation timestamp in ISO 8601 format
​
updated_at
string
Last update timestamp in ISO 8601 format

​
Example request

curl -X GET https://api.syftspace.example/policies/987fcdeb-51a2-43d7-8901-abcdef123456 \
  -H "X-Tenant-ID: your-tenant-id"

​
Example response

{
  "id": "987fcdeb-51a2-43d7-8901-abcdef123456",
  "name": "Rate limit 100/min",
  "policy_type": "rate_limit",
  "configuration": {
    "limit": "100/m",
    "scope": "per_user",
    "applied_to": ["*"]
  },
  "endpoint_id": "123e4567-e89b-12d3-a456-426614174000",
  "created_at": "2026-03-01T10:30:00Z",
  "updated_at": "2026-03-01T10:30:00Z"
}

Build docs developers (and LLMs) love

Get started for freeTalk to us