Aprimo DAM REST API Documentation

After a file upload process is finished, you will receive a file upload token. You can use this token to add or update a record's file or file version. See the examples on creating a record and editing a record for more details on how to do it. Keep in mind, the file upload token can be consumed only once. 404 Not Found error response is returned if you try consuming that token more than once.

A watermark can be applied to a file version and can be configured through the creation of a record and/or editing of a record. For more info, see the Watermark resource page.

Every fileversion can be a publication or a publication item.
By adding the header property "select-fileversion: PublicationItems" publication items of the current fileversion will be returned.

GET /fileversion/id
select-fileversion: PublicationItems

The publicationitems property on the fileversion resource can be set through a PUT or POST (this will create a record with PublicationItems) request on /record/record-id. The fileversion specified in TargetFileVersionId must exist.

PUT /record/8735a5a3e75a4bc0a2a1a3cd0069b669
{
	"files": {
		"addOrUpdate": [
			{
				"id": "da75e95e-e306-4f1d-baeb-a5980109c930",
				"versions": {
					"addOrUpdate": [
						{
							"id": "471CD6A8-29A9-441E-BD09-623903201248",
							"publicationitems": [
								{
									"isManual": false,
									"pageNumber": 1, 
									"targetFileVersionId": "A49312A6-1F8F-4762-B4A5-246828F33597"
								},
								{
									"isManual": false,
									"pageNumber": 2,
									"targetFileVersionId": "3ED5CA3C-87AC-4779-82D0-358D9124157F"
								}
							]
						}
					]
				}
			}
		]
	}
}

NOTE: the "isManual" property is not mandatory, but it is recommended to set this property to true when manually setting publicationitems. If not specified the value is defined by ADAM.

Setting publication items will always overwrite the complete collection.

See the examples on creating a record and editing a record for more details on how to set publication items on a record.