Publish Label definition by ID asynchronously

PUT /api/v1/policy-labels/push/{definitionId}/publish

Asynchronously publishes the policy label definition with the specified ID. Returns a task immediately; poll for completion.

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

Permission: Permissions.STATISTICS_LABEL_CREATE


Request

Path Parameters

Parameter
Type
Required
Description

definitionId

string

Yes

Policy label definition identifier


Response

Success Response

Status: 202 Accepted

{
  "taskId": "63e3e5e8a01b3c001234abcd",
  "expectation": "Publish policy label"
}

Poll GET /tasks/{taskId} to retrieve the result.

Error Responses

Status
Description

401 Unauthorized

Missing or invalid token

403 Forbidden

Insufficient permissions

404 Not Found

Label definition with the specified ID does not exist

422 Unprocessable Entity

definitionId is missing or invalid

500 Internal Server Error

Unexpected server failure

Last updated

Was this helpful?