Rename File (and set file metadata)

Rename File (and set file metadata)

Endpoint URL http://api.webs.com/v1/filemanager/[user]/[path]/[filename]
HTTP Method POST
Parameters apikey=[partner key] (String)
token=[session token] (String)
password=[password] (String) required if token not provided

At least one of the following must be specified:

rename=[new filename] (String)
title=[title] (String)
tags=[tags] (String)
description=[description] (String)
private=[yes | no] (String)

Usage Notes

Omit the path to rename a file in the top-level folder.

You can use this service to rename a file, set file metadata for a file, or both.

Example Good Response

<rsp stat="ok">
  <user name=”blip3">
    <token>e286a13704e8b393112965235ff</token>
    <file fname="cats.jpg" url="http://server/blip3/cats.jpg" size="67.8 Kb" path="">
      <title>This is a big cat</title>
      <tags>cats,feline,animal,tunisia</tags> 
      <description>I took this cat picture in Tunisia.</description>
      <private>true</private>
    </file>
  </user>
</rsp>

Error Codes (see response format in Technical Description)

Code Response
320 Cannot find or create session for user with information provided
340 Does not support this HTTP method for this operation
350 Encountered errors retrieving file list
351 Cannot find file [path]/[filename]
352 Encountered errors setting or retrieving file info
360 Username [name] does not exist
370 Encountered errors during user existence check
382 Encountered errors renaming file

version 14 as of 1 year ago by Brandon

Comments

Please sign in to post a comment.