v1

latestOpenAPI 3.0.32026-08-06138294578.6 KB

Permissions

Get Policy

Returns a single policy by ID, including all action/role bindings it defines.

Returns the full set of action/role bindings defined by the policy, including the resources it applies to.

get/api/permissions/policies/{id}

Path parameters

idstring uuid required

Example:248df4b7-aa70-47b8-a036-33ac447e668d

Headers

X-Polytomic-Versionstring

Response

Example response

{
  "data": {
    "id": "248df4b7-aa70-47b8-a036-33ac447e668d",
    "name": "Policy",
    "organization_id": "248df4b7-aa70-47b8-a036-33ac447e668d",
    "policy_actions": [
      {
        "action": "read",
        "role_ids": [
          "248df4b7-aa70-47b8-a036-33ac447e668d"
        ]
      }
    ]
  }
}