The sendspace Application Programming Interface (API) allows you to embed sendspace services in your applications, programs, or scripts, regardless of platform and programming language.
All communication with the sendspace API (1.2) assumes a UTF-8 encoding.
< Return to Method List
Method: files.moveToFolder
- Description
Moves a file or files into a specific folder.
- Arguments
Name | Mandatory | Description |
session_key | Yes | Received from auth.login |
file_id | Yes | file_id or list of files' id's (a1a1a1,s2s2s2,d3d3d3) |
folder_id | Yes | A folder_id code or 0 for root folder |
- Returns
Full file information(s) and comma-separated list of IDs suceeded to move in an "id" tag. One or several error messages, optionally containing specific reason and IDs of those files failed in an "id" property.
- Response
<!-- successful response -->
<result method="files.movetoFolder" status="ok">
<id>abcdef,abcdeg<id>
<file id="abcdef" ... />
<file id="abcdeg" ... />
</result>
<!-- failed response -->
<result method="files.movetoFolder" status="fail">
<error code="..." text="Permission denied" />
</result>
<!-- mixed response -->
<result method="files.movetoFolder" status="ok">
<id>abcdef,abcdeg<id>
<file id="abcdef" ... />
<file id="abcdeg" ... />
<error code="..." text="..." id="abcdeh,abcdek" />
<error code="..." text="..." id="abcdei,abcdej" />
</result>
- Usage Example
http://api.sendspace.com/rest/?method=files.movetofolder&session_key=9i96woykgory1crglmykgycjwa5k2cq2&file_id=x5l7qv&folder_id=2l28mq
- Possible Errors
Code | Name | Description |
6 | API_ERROR_SESSION_BAD | Session expired or not found |
9 | API_ERROR_FILE_NOT_FOUND | File not found |
10 | API_ERROR_FOLDER_NOT_FOUND | Folder not found |
11 | API_ERROR_PERMISSION_DENIED | Permission denied |