Policies API Reference

A Policy defines the authorization and governance rules that determine what an AI agent is permitted to do. Policies consist of prioritized rules, each containing one or more conditions that evaluate incoming requests.

Policies are evaluated by Synentra before requests are forwarded to the target service.

Base URL

Throughout this guide the base URL is assumed to be your running server, e.g. http://localhost:7080. Replace <BASE_URL> in the examples with your actual server address.

---

API Endpoints

Get policies list

Returns a paginated list of all policies.

GET <BASE_URL>/policies?page=1&pageSize=25

URL Parameters

Parameter	Type	Default	Description
page	int	1	Page number
pageSize	int	25	Items per page

Examples

Example of invoking a method on an action:

cURL

curl "http://localhost:7080/policies?page=1&pageSize=25"

JavaScript

fetch(`http://localhost:7080/policies?page=1&pageSize=25`)
.then(res => res.json())
.then(console.log);

Python

import requests

response = requests.get(
    f'http://localhost:7080/policies',
    params={'page': 1, 'pageSize': 25}
)
print(response.json())

Response 200 OK

{
  "items": [
    {
      "policyName": "data-agent",
      "description": "Governs a data-pipeline agent",
      "owner": "data-team",
    }
  ],
  "page": 1,
  "pageSize": 25,
  "totalCount": 1
}

---

Get policy details

GET <BASE_URL>/policies/{name}

URL Parameters

Parameter	Type	Default	Description
name	string	``	The policy name to getting details

Examples

Example of invoking a method on an action:

cURL

curl "http://localhost:7080/policies/data-agent"

JavaScript

fetch(`http://localhost:7080/policies/data-agent`)
.then(res => res.json())
.then(console.log);

Python

import requests

response = requests.get(
    f'http://localhost:7080/policies/data-agent'
)
print(response.json())

Response 200 OK

{
  {
    "name": "data-agent",
    "description": "Governs a data-pipeline agent",
    "owner": "data-team",
    "CreatedOn": "2026-07-19T15:42:31Z",
    "Default": "hitl",
    "Rules": []
  }
}