Use the publish API to submit assets for approval if your organization has enabled workflow for managing approvals of data access control assets.
Assign one or more stakeholders to the asset before submitting it for approval. The submission creates a workflow ticket and assigns the tasks configured for the workflow to the stakeholders of the asset. The asset stakeholder approves, rejects, or reassigns the tasks.
If your organization has not enabled workflow in Metadata Command Center, the publish API returns an error.
For more information about enabling workflow, see Workflows in the Metadata Command Center help.
Publish API endpoints
Send a request to submit a draft data access asset for workflow review. The prefix, indicated by <prefix>, for each endpoint is /data360/dam/api/v1/.
The following table describes method and endpoint for the publish API:
Method
Endpoint
Description
POST
<baseApiUrl>/data360/dam/api/v1/publish
Create a workflow ticket and submit a specific asset for review.
The request body includes details needed to create the workflow ticket.
Request parameters
The following table describes the parameters that you can specify in the endpoint of the request:
Parameter
Type
Description
id
String
Required. Specify the internal ID of the asset that you want to publish.
classType
String
Required. Specify one of the following class types:
- DATA_ACCESS_CONTROL
- DATA_DE_IDENTIFICATION
- DATA_FILTER
- DATA_PROTECTION
- PRECEDENCE_TIER
ticketDetails
Object
Required. Specify the details of the workflow ticket to create when publishing the asset.
ticketTitle: String. Title of the ticket.
ticketDescription: String. Description of the ticket.
severity: Reference. Severity of the ticket. Select one of the following:
- HIGH
- MEDIUM
- LOW
urgency: Reference. Urgency of the ticket. Select one of the following:
- BLOCKER
- MAJOR
- MINOR
Request body
In the body of the request, specify the parameters in the following format:
{
"id": "",
"classType": "PRECEDENCE_TIER",
"ticketDetails": {
"ticketTitle": "Send for Approval",
"ticketDescription": "Please approve this change.",