Retrieval of Data from Root Policy Block

GET /policies/{policyId}/blocks

Returns data from the root policy block for the specified policy.

Authentication: Bearer token required (Authorization: Bearer <token>)

Permission: Permissions.POLICIES_POLICY_EXECUTE or Permissions.POLICIES_POLICY_MANAGE

Request

Parameter

Type

Required

Description

policyId

string

Yes

The policy ID (MongoDB ObjectId, e.g. 63e3e5e8a01b3c001234abcd)

Status: 200 OK

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "blockType": "interfaceContainerBlock",
  "children": []
}

Status

Description

401 Unauthorized

Missing or invalid token

403 Forbidden

Insufficient permissions

404 Not Found

Policy not found

503 Service Unavailable

Policy block is temporarily unavailable

500 Internal Server Error

Unexpected server failure

Was this helpful?