Retrieves Block Data by Tag

GET /policies/{policyId}/tag/{tagName}/blocks

Requests block data for the block identified by tag name within 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)

tagName

string

Yes

The block tag name (e.g. submit_application)

Status: 200 OK

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "blockType": "requestVcDocumentBlock",
  "schema": "#iREC_Application",
  "data": {}
}

Status

Description

401 Unauthorized

Missing or invalid token

403 Forbidden

Insufficient permissions

404 Not Found

Policy or block with given tag not found

503 Service Unavailable

Policy block is temporarily unavailable

500 Internal Server Error

Unexpected server failure

Was this helpful?