Download validation requests
This relation targets download validation requests.
Create a download validation request
This relation targets download validation requests for authenticated users.
POST /api/dam/download-validation-requests
{
"mediaIds": [
37,
22,
50411
],
"reason": "I really like these medias",
"responsibleIds": [
8,
91
]
}
Request body must contain the following attributes:
-
reason
: A string containing the request reason that will be read by the validation responsible.
Request body can contain the following attributes:
-
mediaIds
: An array of integers containing the identifiers of the requested medias. -
responsibleIds
: An array of integers containing the identifiers of the users who will receive a notification about the request and be able to validate it.
If the download validation request is created with success, the HTTP status of the response will be 201
. It is then possible to get the location of the newly created resource in the Location
HTTP response header.
4.65.0
Create a public download validation request
This relation targets public download validation requests. It allows external users to create a download request. By default, this path is disabled, it can be enabled with the ENABLE_PUBLIC_DOWNLOAD_REQUEST technical property.
POST /api/public/download-validation-requests
{
"mediaIds": [
37,
22,
50411
],
"firstName": "Firstname",
"lastName": "Lastname",
"mail": "firstname.lastname@domain",
"reason": "I really like these medias",
"responsibleIds": [
8,
91
]
}
Request body must contain the following attributes:
-
mediaIds
: An array of integers containing the identifiers of the requested medias. -
firstName
: Firstname of user creating the request. -
lastName
: Lastname of user creating the request. -
mail
: E-mail of user creating the request. -
reason
: A string containing the request reason that will be read by the validation responsible.
If external user does not exist, it will be created with firstName
, lastName
and mail
properties. If external user mail
match existing external user, firstName
and lastName
properties must exactly match existing user. Otherwise, download request will be rejected.
Request body can contain the following attributes:
-
responsibleIds
: An array of integers containing the identifiers of the users who will receive a notification about the request and be able to validate it. Identifiers are taken in account ifCAN_CHOOSE_DOWNLOAD_REQUEST_RESPONSIBLES
technical property is enabled.
If no responsible identifiers are provided, download request will be sent to folder responsible users if REQUEST_DOWNLOAD_FOLDER_MODE_ENABLED
technical property is enabled. Otherwise, external users responsible will be notified.
If the download validation request is created with success, the HTTP status of the response will be 201
. It is then possible to get the location of the newly created resource in the Location
HTTP response header.
4.73.0