file_storage/modify_file.php

Last modified by YellowFox_RD on 2024/12/19 10:11

Table of Contents

Allows editing the meta information of a single file from file storage.

Description

GET   /file_storage/modify_file.php?company=RTI_COMPANYKEY&import=IMPORTKEY&file=UUID&action=action

Parameters

ParameterDescriptionTypeNoteMandatory
companyRTI company keystringyes
importRTI import keystringyes
fileUUID of requested filestringYou can receive this value via file_storage/get_overview.php or a sreturn value from file_storage/upload_file.php, if the file was directly uploaded via RTI.yes
actionaction typestringpossible values:
  • BIN: move file to bin
  • DELETE: delete file permanently (attention: This removes the file permanently so it can not be restored!)
  • RESTORE: restore a file from bin
  • RENAME: change shown name of file
  • MOVE: move file to another directory
yes
namenew name of filestringonly relevant if action "RENAME"(yes)
pathnew path of filestringonly relevant if action "MOVE"
Format: folder/subfolder/.../target folder (separated by /)
Root does not have to be specified. To move the file to root directory, just leave the param empty.
Paths are case insensitive.
(no)

Return

On success you will receive "OK". On missing parameters or errors you will receive "ERROR:description".

Example calls

set a new name
https://map.yellowfox.de/rti/file_storage/modify_file.php?company=COMPANY_RTIKEY&import=IMPORT_RTIKEY&file=UUID&action=RENAME&name=neuer name

move file
https://map.yellowfox.de/rti/file_storage/modify_file.php?company=COMPANY_RTIKEY&import=IMPORT_RTIKEY&file=UUID&action=MOVE&path=Bilder/Fotos