List policies
GET/v1/directory/policies
Lists your organization's policies, their permissions and the roles that hold them.
Permission: identity:ListPolicies
Returns
200 OK
{
"policies": [
{
"id": "7d8e9f0a-1b2c-4d3e-8f4a-5b6c7d8e9f0a",
"name": "Agent builders",
"description": "Create and edit agents",
"kind": "policy",
"policy_ids": [],
"role_ids": [
"5a1b2c3d-4e5f-4a6b-8c7d-9e0f1a2b3c4d"
],
"account_ids": [],
"permissions": [
"agents:CreateAgent",
"agents:UpdateAgent"
],
"managed": false,
"builtin": "",
"role": "",
"created_at": "2026-11-19T09:00:00Z",
"updated_at": "2026-11-19T09:00:00Z"
}
]
}Example
curl https://<company>.yotta.bot/v1/directory/policies \
-H "Authorization: Bearer $YOTTABOT_TOKEN"With yottactl
yottactl org policies list