Assets Server REST API - updateAuthKey – Help Center

POST

http://yourserver.com/services/updateAuthKey
    ?key=<authKey>
    &subject=<subject>
    &validUntil=<Expiry date>
    &description=<Description>
    &downloadOriginal=<true|false>
    &downloadPreview=<true|false>
    &requestApproval=<true|false>
    &requestUpload=<true|false>
    &containerId=<Container asset id>
    &importFolderPath=<Path where files are uploaded>
    &notifyEmail=<Email address>
    &sort=<comma-delimited sort fields>
    &downloadPresetIds=<List of download preset ids>

What does it do?

Update an authKey in Assets Server.

With this API call it is possible to update certain properties of an authKey. Please note that it is not possible to add or remove assets from an authKey once it has been created.

Log in requirement

Before being able to request information from Assets Server by using a GET request or make changes to the system through a POST request, a log in to Assets Server is required. For information about the available APIs for logging in, see Assets Server REST API - introduction.

POST requests only

This REST API only accepts POST requests, not GET requests. Also, the POST request needs to include a cross-site request forgery (csrf) token.

The csrf token is a unique code which, by including it in the request, also makes the POST request unique and therefore much more secure.

The csrf token is obtained by first logging in to Assets Server through a POST request. The response that is received will include the csrf token which can then be used in subsequent POST requests as a http header:

"X-CSRF-TOKEN: <some_csrf_token>"

For more information including examples, see Assets Server REST API - Performing a POST request with a csrf token.

Parameters

key	The authKey which will be updated. Required.
subject	AuthKey subject. When specified, parameter is not allowed to be empty, for example by adding 'subject='. Optional.
validUntil	Expiry date, in one of the date formats supported by Assets Server, see the query syntax guide for details. When specified, parameter is not allowed to be empty, for example by adding 'validUntil='. Optional.
description	AuthKey description that will be shown to receiver of the link. Optional.
downloadOriginal	Allow downloading original files. Setting this to true will automatically force downloadPreview to true as well. Optional. Default is false.
downloadPreview	Allow viewing and downloading previews. Setting this to false will only show thumbnails and will also force downloadOriginal to false. Optional. Default is false.
requestApproval	Request for approval. Optional. Default is false.
requestUpload	Allow uploading new files, must be true when asset id's is not specified. Optional. Default is false.
containerId	Container asset id which uploaded files are related to. Required when requestUpload=true. Optional.
containerIds	List of container IDs which content is available for preview or download though a Shared Link. When the content of the container is updated, the content of the Shared Link is updated as well. Optional.
importFolderPath	folderPath where files are uploaded. Required when requestUpload=true. Optional.
notifyEmail	Email address to send notifications to when upload or approval is finished. Only relevant when requestUpload=true or requestApproval=true. Optional.
sort	Client setting, specify a comma-delimited list of fields to sort the results on. Follows the same behavior as sort in REST - search call, see also REST - search. Optional.
downloadPresetIds	Comma-delimited list of Download Preset id's. Allows the downloading of renditions generated according to these Preset settings. IDs that do not exist or that are not accessible for the user are not accepted by the API. In such cases, an 'IllegalArgumentException' error with an explanation message is returned containing the ID of the incorrectly downloaded preset. Example: `{` `"errorname": "IllegalArgumentException",` `"message": "You cannot share these download presets, because they don't exist or you don't have permission: 8cP4nL8Tao09koYG87E1s9",` `"errorcode": 500` `}` Optional.

Return value

If the operation succeeds an empty JSON object with status 200 will be returned. If the operation fails, an error page with a 500 error status will be returned.

Examples

updateAuthKey

http://demo.assets-server.com/services/updateAuthKey
    ?key=aayy4ZE
    &requestUpload=true
    &importFolderPath=/Users/admin

This call updates an authKey to allow uploading of assets by setting requestUpload to "true" and setting the importFolderPath to "/Users/admin".

Simple update description