Policy Creation APIs

Base URL: /api/v1

These APIs enable Standard Registry users to create, configure, publish, and manage Guardian policies. Users and auditors can also interact with running policies via block and group endpoints.

Authentication: All endpoints require a valid JWT Bearer token (Authorization: Bearer <token>). Obtain a token via POST /accounts/login.

See Prerequisite Steps before getting started.

---

Endpoints

Method	Endpoint	Description	Auth Required
GET	/policies	List all policies	Yes
POST	/policies	Create a new policy	Yes
GET	/policies/{policyId}	Get policy configuration	Yes
PUT	/policies/{policyId}	Update policy configuration	Yes
PUT	/policies/{policyId}/publish	Publish a policy	Yes
POST	/policies/validate	Validate policy configuration	Yes
GET	/policies/{policyId}/blocks	Get root policy block data	Yes
GET	/policies/{policyId}/blocks/{uuid}	Get block data by UUID	Yes
POST	/policies/{policyId}/blocks/{uuid}	Send data to a block	Yes
GET	/policies/{policyId}/tag/{tagName}	Get block ID by tag	Yes
GET	/policies/{policyId}/tag/{tagName}/blocks	Get block data by tag	Yes
POST	/policies/{policyId}/tag/{tagName}/blocks	Send data to block by tag	Yes
GET	/policies/{policyId}/groups	List groups for the current user	Yes
POST	/policies/{policyId}/groups	Set the active group	Yes
GET	/policies/{policyId}/export/file	Export policy as zip	Yes
GET	/policies/{policyId}/export/message	Export policy message ID	Yes
POST	/policies/import/file	Import policy from zip	Yes
POST	/policies/import/message	Import policy from IPFS	Yes
POST	/policies/import/message/preview	Preview policy from IPFS	Yes

---

Endpoint Details

• Prerequisite Steps — Authentication and account setup

• Policy Listing — GET /policies

• Creation of a Policy — POST /policies

• Retrieves Policy Configuration — GET /policies/{policyId}

• Updates Policy Configuration — PUT /policies/{policyId}

• Publish a Policy — PUT /policies/{policyId}/publish

• Policy Validation — POST /policies/validate

• Retrieval of Data from Root Policy Block — GET /policies/{policyId}/blocks

• Request Block Data — GET /policies/{policyId}/blocks/{uuid}

• Sends Data to Specified Block — POST /policies/{policyId}/blocks/{uuid}

• Returns Block ID by Tag — GET /policies/{policyId}/tag/{tagName}

• Retrieves Block Data by Tag — GET /policies/{policyId}/tag/{tagName}/blocks

• Sends Data to Specified Block by Tag — POST /policies/{policyId}/tag/{tagName}/blocks

• Returns List of Groups of a Particular User — GET /policies/{policyId}/groups

• Make the Selected Group Active — POST /policies/{policyId}/groups

• Export to Zip File — GET /policies/{policyId}/export/file

• Exporting Message ID — GET /policies/{policyId}/export/message

• Import a Policy — POST /policies/import/message

• Import from Zip File — POST /policies/import/file

• Policy Preview from IPFS — POST /policies/import/message/preview

• Dynamic Policy Fields Guide — Dynamic field configuration reference