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