Skip to main content
Ask ChatGPT

Using DAM Assets in PM Workflows

Productivity Management

This tutorial is exclusive to Aprimo Productivity Management

Rate Limiting

Before you begin developing, read about Aprimo Rate Limiting.

1. Retrieve the DAM Record ID of a DAM Asset on a Task​

  1. Get Current Documents:
    GET /api/tasks/{taskID}/documents
    • Check the _embedded attribute for all current documents.
  2. Filter DAM Assets:
    Look for objects with category: aprimodam.
  3. Get DAM Record ID:
    GET /api/digital-assets/{documentID}
    • The damRecordId attribute contains the DAM ID.

2. Add an Aprimo DAM Asset to a Task Configured for a Digital Asset​

  1. Get File and DAM Record IDs:
    Retrieve the file ID (record/[recordid]/files) and DAM record ID.

  2. Map DAM Asset: POST /digital-assets/dam-mapping

{
    "damRecordId": "'{1}'",
    "assetTypeId": 401,
    "damFileId": "'{2}'"
}

This returns an assetid and versionid needed for the next steps.

  1. Add Asset to Project: PUT /projects/{projectID}/digital-assets/{assetid}

  2. Retrieve Document ID: GET /tasks/{taskID}/documents

  3. Attach Asset to Task: PUT /tasks/{taskID}/document-uploads/{documentID}/upload-document

{
  "versionId": "{versionId}"
}

3. Removing an Asset from a Task​

Use the API to detach a file or Aprimo DAM document from a task.

  1. Retrieve the Document ID:
    GET /tasks/{taskID}/documents

  2. Retrieve the Version ID:
    GET /tasks/{taskID}/document-uploads/{documentID}/uploaded-versions

  3. Remove the Asset:
    DELETE /tasks/{taskID}/document-uploads/{documentID}/uploaded-versions/{versionID}

    • This removes the attachment or DAM asset from the task.