sendspace Developer | Documentation

Home API Howto Full API Guide API Keys Downloads API Support

sendspace API (beta) Developer Guide 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 (beta) 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
time_limit	No	Seconds until limit reached
downloads_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="" name="" description="" password="" folder_id="" download_page_url="" direct_download_url="" upload_time="" file_size="" downloads="" time_limit="" download_limit="" limit_action="" limit_action_to_folder=""/>
</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