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.setInfo
- Description
Updates information about a specific file.
- 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) |
name | No | Only use if you want to change data. Sending empty will clear existing data. |
description | No | Only use if you want to change data. Sending empty will clear existing data. |
password | No | Only use if you want to change data. Sending empty will clear existing data. |
folder_id | No | A folder_id code or 0 for root folder |
business_shared | No | 1 to set, 0 to unset folder as shared to your business team. Only works for business plan users and top-level folders. |
time_limit | No | Seconds until limit reached |
download_limit | No | Total number of downloads until limit reached |
limit_action | No | Action to perform when reached limit (1=block downloads, 2=delete file, 3=move file to a different folder) |
limit_action_to_folder | No | folder_id if limit_action is 3 |
- Returns
Full and up to date file information if the operation was successful
- Response
<result method="files.setInfo" status="ok">
<file id="" ... />
</result>
- Usage Example
http://api.sendspace.com/rest/?method=files.setinfo&session_key=9i96woykgory1crglmykgycjwa5k2cq2&file_id=hklv47&name=Crazy+frog+-+Popcorn.mp3&folder_id=k6vpyz
- 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 |