Update a file
Description
A User or External Entity on behalf of a User with role permission MEDIA_FILE_OWNER will go through all steps of “Get media files by the specified filter” Use Case and then send a request to Endpoint “Update a file”.
Actors
- External Entity that can interact with System Operator API acting as a registered System Operator User with permissions: MEDIA_FILE_OWNER.
- System Operator running “SDK.Finance” software and exposing the portfolio of financial APIs.
Preconditions
- The user must have a System Operator profile with sufficient access privileges.
Basic Flow
By default, this flow assumes that External Entity sends Requests to System Operator Endpoints, and System Operator sends back Responses to External Entity.
- Perform all steps of Use Case “Get media files by the specified filter”.
- External Entity sends a request to Endpoint “Update a file”.
Endpoint URL: https://sdkfinance.app/api/ui/#!/Media_files_management/Update_file
Parameters:
Authorization – authorization token
id – file identifier
Request body example:
{ "tag":"string" } |
- System Operator returns result information to External Entity. (See Result example below)
Optional Flow with Web Browser UI
- Perform all steps of Use Case “Get media files by the specified filter”.
- A user sends a request to Endpoint “Update a file”.
Endpoint URL: https://sdkfinance.app/api/ui/#!/Media_files_management/Update_file
Parameters:
Authorization – authorization token
id – file identifier
Request body example:
{ "tag":"string" } |
- System Operator returns result information to User (See Result example below).
Post Conditions
The updated file is available.
Result example
{ "file":{ "id":"string", "ownerId":"string", "mediaType":"string", "name":"string", "url":"string", "md5":"string", "sha1":"string", "size":0, "used":false, "createdAt":"2018-08-16T14:36:20.982Z", "expiresAt":"2018-08-16T14:36:20.982Z", "tag":"string" }, "status":"ok", "message":"string" } |