Getting Started

Billing

Contact

Device

Download

File

Folder

System

Upload

User

FolderUnversioned

Copy


Description : Copy a folder and its content to another folder. If the folder is not owned by the session user, it will be added as a linked folder.

Required Parameters

  • session_token : A type 1 or type 2 session token. (Type 2 will require a call signature).
  • folder_key_src : The folderkey source is the folderkey of the desired folder you wish to copy. You can also specify multiple folderkeys separated by commas.

Optional Parameters
  • signature : This is the call signature that is required to authenticate a type 2 session token transaction.
  • folder_key_dst : The folderkey destination is the folderkey of the desired folder you wish to copy folder(s) to. If omitted, the foldersource(s) will be copied to root (My Files).
  • response_format : 'xml' or 'json' (default 'xml')


GET http://www.mediafire.com/api/unversioned/folder/copy.php
POST http://www.mediafire.com/api/unversioned/folder/copy.php

Example:

Request 
http://www.mediafire.com/api/unversioned/folder/copy.php?session_token=3f643fbbda95b7dfc4a094927a8bb23cde7bc64481f015eabca2559ae1835984c85566f97882e4c598e5702f556064e22bb9e8f6b9d12a67a7bd74e4bdd553c958e489572cd0d1fc&folder_key_src=bbm411lcts280&folder_key_dst=d2udzgjn5l5vd
Response 
<response>
    <action>folder/copy</action>
    <new_folderkeys>
        <new_folderkey>8adbweycihdkd</new_folderkey>
    </new_folderkeys>
    <result>Success</result>
    <current_api_version>2.14</current_api_version>
</response>

Create


Description: Creates a folder.

Required Parameters:


Optional Parameters:
  • signature : This is the call signature that is required to authenticate a type 2 session token transaction.
  • parent_key : The key that identifies an existing folder (use the folderkey to assign the folder) in which the new folder is to be created. If not specified, the new folder will be created in the root folder (My files).
  • allow_duplicate_name : Allow the folder to be created if another folder with the same name in the same folder already exists. If set to 'yes' the new folder will be created but a number will be added to the end of the folder name (i.e. myfolder, myfolder(2), myfolder(3), and so on). If set to 'no' and folder name already exists, information for the existing folder will be returned. 'yes' or 'no' (default 'yes').
  • mtime : The creation date/time of the added folder. If not set, current server time will be used. Refer to the following document for valid date & time formats: http://www.php.net/manual/en/datetime.formats.php
  • response_format : 'xml' or 'json' (default 'xml')


GET http://www.mediafire.com/api/unversioned/folder/create.php
POST http://www.mediafire.com/api/unversioned/folder/create.php

Example:

Request 
http://www.mediafire.com/api/unversioned/folder/create.php?session_token=123456789012345678901234567890123456789012345678901234567890&foldername=newfolder&version=1
Response 
<response>
    <action>folder/create</action>
    <folder_key>n1b56566wj29q</folder_key>
    <upload_key>a4c4a65d2e89a11733e9b61320d48100e04e75f6e8ebb871</upload_key>
    <result>Success</result>
</response>

Delete


Description: Delete a user's folder. If called, the folder is not deleted permanently but, rather, the folder is moved to the trash can.

Required Parameters:

  • session_token : A type 1 or type 2 session token. (Type 2 will require a call signature).
  • folder_key : The key that identifies the folder to be deleted. You can also specify multiple folderkeys separated by commas.

Optional Parameters:
  • signature : This is the call signature that is required to authenticate a type 2 session token transaction.
  • response_format : 'xml' or 'json' (default 'xml')

GET http://www.mediafire.com/api/unversioned/folder/delete.php
POST http://www.mediafire.com/api/unversioned/folder/delete.php

Example:

Request 
http://www.mediafire.com/api/unversioned/folder/delete.php?session_token=3f643fbbda95b7dfc4a094927a8bb23cde7bc64481f015eabca2559ae1835984c85566f97882e4c598e5702f556064e22bb9e8f6b9d12a67a7bd74e4bdd553c958e489572cd0d1fc&folder_key=0dwzor67253tu
Response 
<response>
    <action>folder/delete</action>
    <myfiles_revision>
        <revision>2.0</revision>
        <epoch>1361220899</epoch>
    </myfiles_revision>
    <result>Success</result>
    <current_api_version>2.14</current_api_version>
</response>

Get Content


Description: Returns either a list of folders or a list of files.

Required Parameters:

  • folder_key : The key that identifies the folder to be returned. If not passed, then it will return the root folder (session token is then required).
OR
Optional Parameters:
  • signature : This is the call signature that is required to authenticate a type 2 session token transaction.
  • content_type : Request what type of content ('folders' or 'files'). If not passed, it defaults to 'folders'.
  • filter : Filter by privacy and/or by filetype. This is a comma-separated list of file types and privacy options and can take one or more of the following values : "public", "private", "image", "video", "audio", "document", "spreadsheet", "presentation", "application", "archive", "data", and "development". If content_type is 'folders', only 'public' and 'private' filters are honored.
  • device_id : Specify which device to return the myfiles data from. If not set, it defaults to the cloud.
  • order_by : 'name', 'created', 'size', 'downloads' (default 'name'). In case of requesting folders, only 'name' and 'created' are considered; anything else will default to 'name'.
  • order_direction : Order direction: 'asc' or 'desc' (default 'asc').
  • chunk : The chunk number starting from 1.
  • details : "yes", "no", or "shallow" ("no" by default). If "yes", the API returns the '''total_files''', '''total_folders''', and '''total_size''' for all the contained folders and files recursively of each folder. However, there is a limit on how many items can be counted. If the limit is reached, an extra property '''overflow''' will be returned as well. If "shallow" is specified, the API returns the '''byte_count''' of files immediately inside each folder (non-recursive).
  • response_format : 'xml' or 'json' (default 'xml')


GET http://www.mediafire.com/api/unversioned/folder/get_content.php
POST http://www.mediafire.com/api/unversioned/folder/get_content.php

Example 1 (Folders):

Request 
http://www.mediafire.com/api/unversioned/folder/get_content.php?folder_key=dh7ry84hqwh7t&session_token=12345678901234567890123456789012345678901234567890123456789012345678901234567890&content_type=folders
Response 
<response>
    <action>folder/get_content</action>
    <folder_content>
        <chunk_size>100</chunk_size>
        <content_type>folders</content_type>
        <chunk_number>1</chunk_number>
        <folders>
            <folder>
                <folderkey>1o2cqdg26o1ab</folderkey>
                <name>Sumfin</name>
                <description/>
                <tags/>
                <privacy>public</privacy>
                <created>2013-02-26 16:55:34</created>
                <flag>2</flag>
                <shared_by_user>1</shared_by_user>
                <permissions>2</permissions>
                <folder_count>0</folder_count>
                <file_count>0</file_count>
                <revision>
                    <revision>1</revision>
                    <epoch>1366050311</epoch>
                </revision>
                <shared>no</shared>
                <dropbox_enabled>no</dropbox_enabled>
            </folder>
        </folders>
    </folder_content>
    <result>Success</result>
    <current_api_version>2.14</current_api_version>
</response>

Example 2 (Files):

Request 
http://www.mediafire.com/api/unversioned/folder/get_content.php?folder_key=dh7ry84hqwh7t&session_token=12345678901234567890123456789012345678901234567890123456789012345678901234567890&content_type=files
Response 
<response>
    <action>folder/get_content</action>
    <folder_content>
        <chunk_size>100</chunk_size>
        <content_type>files</content_type>
        <chunk_number>1</chunk_number>
        <files>
            <file>
                <quickkey>cg66p0rrzs9grir</quickkey>
                <filename>css workarounds.css</filename>
                <description/>
                <size>1628</size>
                <privacy>public</privacy>
                <created>2013-02-21 18:29:54</created>
                <password_protected>no</password_protected>
                <filetype>development</filetype>
                <mimetype>text/css</mimetype>
                <flag>22</flag>
                <shared_by_user>1</shared_by_user>
                <permissions>2</permissions>
                <hash>7b9bdd3a1d24a9aae52639563c1a1f8dee73572366b8ebf999250f32268f2e62</hash>
                <downloads>0</downloads>
                <views>0</views>
            </file>
        </files>
    </folder_content>
    <result>Success</result>
    <current_api_version>2.14</current_api_version>
</response>

Property: flag
Please refer to file/get_info and folder/get_info for details about this property.
Property: shared_by_user
Will be set to '1' if the user has shared the file with anyone. Not present otherwise.
Property: permissions
Present if user has been granted permissions for the file. Decimal value of bit mask field. Bit 0 = read; 1 = read + write; 2 = manage.


Get Depth


Description: Returns information about folder nesting (distance from root).

Required Parameters:


Optional Parameters:
  • signature : This is the call signature that is required to authenticate a type 2 session token transaction.
  • response_format : 'xml' or 'json' (default 'xml')

GET http://www.mediafire.com/api/unversioned/folder/get_depth.php
POST http://www.mediafire.com/api/unversioned/folder/get_depth.php

Example:

Request 
http://www.mediafire.com/api/unversioned/folder/get_depth.php?session_token=7bc1f2bdf00920e37553f1eaa04078fbdf5c28d8a3e6144ff26f89d3d980272a4561f99c404e70d9ffc8abf4220eba4f30e9d68132f6ae1f5a38342831d9b3c917504f5a01524bde&folder_key=2509mz6sb9swz
Response 
<response>
    <action>folder/get_depth</action>
    <folder_depth>
        <depth>2</depth>
        <chain_folders>
            <chain_folder>
                <folderkey>2509mz6sb9swz</folderkey>
                <name>1</name>
            </chain_folder>
            <chain_folder>
                <folderkey>d3h9rqbm1dj3y</folderkey>
                <name>_3</name>
            </chain_folder>
        </chain_folders>
    </folder_depth>
    <result>Success</result>
    <current_api_version>2.14</current_api_version>
</response>

Get Flags


Deprecated. Use folder/get_info instead.

Description : Returns a bitmask value of special information about a folder.

Required Parameters:

  • session_token : A type 1 or type 2 session token. (Type 2 will require a call signature). Needed only when accessing user's private files.
  • folder_key : The key that identifies the folder requiring flag information. You can also specify multiple folderkeys separated by commas.

Optional Parameters:
  • signature : This is the call signature that is required to authenticate a type 2 session token transaction.
  • response_format : 'xml' or 'json' (default 'xml')

GET http://www.mediafire.com/api/unversioned/folder/get_flags.php
POST http://www.mediafire.com/api/unversioned/folder/get_flags.php

Example:

Request 
http://www.mediafire.com/api/unversioned/folder/get_flags.php?session_token=736d51e04a51a2210f6182951d84bad3e9de5fa0dc12894589e83fa434e5276f9cc7f4aa00bf883d7269ec51ddd911014e30eac29ad754db7c8bfa166f7130373b39d6595a9dfda7&folder_key=a53ydyzabc35f
Response 
<response>
    <action>folder/get_flags</action>
    <folder_flag>
        <folderkey>a53ydyzabc35f</folderkey>
        <flags>0</flags>
    </folder_flag>
    <deprecated>yes</deprecated>
    <result>Success</result>
    <current_api_version>2.14</current_api_version>
</response>

Get Info


Description : Returns a list of a folder's details.

Required Parameters:

  • folder_key : The key that identifies the folder requiring information. if not passed, then it will return the root folder (session token is then required).
OR
Optional Parameters:
  • signature : This is the call signature that is required to authenticate a type 2 session token transaction.
  • device_id : Specify which device to return the myfiles data. If not set, it defaults to the cloud.
  • details :Designations are "yes", "no", or "shallow" ("no" by default). If "yes", the API returns the total_files, total_folders, and total_size for all the contained folders and files recursively of each folder. There is a limit on how many items can be counted. If the limit is reached, an extra property overflow will be returned as well. If "shallow" is specified, the API returns the byte_count of files immediately inside each folder (non-recursive).
  • response_format : 'xml' or 'json' (default 'xml')

GET http://www.mediafire.com/api/unversioned/folder/get_info.php
POST http://www.mediafire.com/api/unversioned/folder/get_info.php

Example:

Request 
http://www.mediafire.com/api/unversioned/folder/get_info.php?session_token=123456789012345678901234567890123456789012345678901234567890&folder_key=wl88kcc0k0xvj&version=1
Response 
<response>
    <action>folder/get_info</action>
    <folder_info>
        <folderkey>wl88kcc0k0xvj</folderkey>
        <name>myfolder</name>
        <desc/>
        <tags/>
        <created>2011-01-07 12:24:34</created>
        <revision>2</revision>
        <epoch>1381236999</epoch>
        <parent_folderkey>poq8du83hf9w</parent_folderkey>
        <custom_url>custom</custom_url>
        <dbx_enabled>1</dbx_enabled>
        <file_count>2</file_count>
        <folder_count>1</folder_count>
        <total_folders>1</total_folders>
        <total_files>2</total_files>
        <total_size>12345</total_size>
        <flag>2</flag>
        <shared_by_user>1</shared_by_user>
        <permissions>2</permissions>
        <owner_name>Anonymous</owner_name>
        <avatar>http://link.to/avatar</avatar>
    </folder_info>
    <result>Success</result>
</response>

Property: flag
This is a bit-mask value indicating special details about a folder. The following is a list of bits and their meanings:

  • 1: Indicates whether this folder is owned by the current session user.

Flag bits in bold are reserved and should not be publicly documented at the moment.

Property: shared_by_user
Will be set to '1' if the user has shared the file with anyone. Not present otherwise.
Property: permissions
Present if user has been granted permissions for the file. Decimal value of bit mask field. Bit 0 = read; 1 = read + write; 2 = manage.


Get Revision


Description : Returns a number indicating the revision of the folder identified by folder_key. Any changes made to this folder or its content will increment the revision. When the revision resets to '1', the timestamp epoch is updated so both revision and epoch can be used to identify a unique revision. .

Required Parameters:

  • folder_key : The key that identifies the folder. If not passed, the root folder will be returned(session token is then required).
OR
Optional Parameters:
  • signature : This is the call signature that is required to authenticate a type 2 session token transaction.
  • return_changes : Specify whether or not to return the changes made to the files or folders. Responses are 'yes' or 'no' (default 'no'). Deprecated. Use device/get_changes instead.
  • response_format : 'xml' or 'json' (default 'xml')

GET http://www.mediafire.com/api/unversioned/folder/get_revision.php
POST http://www.mediafire.com/api/unversioned/folder/get_revision.php

Example:

Request 
http://www.mediafire.com/api/unversioned/folder/get_revision.php?folder_key=zaj0wjzqw23cf&return_changes=yes
Response 
<response>
    <action>folder/get_revision</action>
    <changes>
        <add>file-fj3478fje3dje-5,file-395753jcn33dje-6,</add>
        <remove>folder-jhjf84jfg2jf74uj-5,</remove>
        <update/>
    </changes>
    <revision>541</revision>
    <epoch>1296321580</epoch>
    <result>Success</result>
</response>

Get Siblings


Description : Returns the sibling folders.

Required Parameters:

  • folder_key : The key that identifies the folder requiring sibling information. If not passed, then it will return the root folder (session token is then required).

Optional Parameters:
  • session_token : A type 1 or type 2 session token. (Type 2 will require a call signature) Only needed when accessing a user's private folders.
  • signature : This is the call signature that is required to authenticate a type 2 session token transaction.
  • start : Request to return results or a subset of the siblings starting from this number.
  • limit : The maximum results to be returned.
  • response_format : 'xml' or 'json' (default 'xml')

GET http://www.mediafire.com/api/unversioned/folder/get_siblings.php
POST http://www.mediafire.com/api/unversioned/folder/get_siblings.php

Example:

Request 
http://haibiztest.mediafire.com/api/unversioned/folder/get_siblings.php?session_token=8b78feee3ab222b568b31d991b1f91a14227e2fc8e665f65846b638173e46c90e4858364d7ef049d18e6be071115fc4e732556e755f0611008176616133b7905f5d353477844f820&folder_key=lzknk841487c1
Response 
<response>
    <action>folder/get_siblings</action>
    <siblings>
        <sibling>
            <folderkey>ixskrduth0rgs</folderkey>
            <name>__bulk</name>
            <description />
            <tags />
            <created>2013-01-25 15:16:21</created>
            <privacy>public</privacy>
            <file_count>1</file_count>
            <revision>13</revision>
            <epoch>1361220901</epoch>
            <owner_name>Testbiz</owner_name>
            <avatar>https://secure.gravatar.com/avatar/00000000?s=27&d=mm&f=y</avatar>
            <dropbox_enabled>no</dropbox_enabled>
            <flag>2</flag>
            <folders />
            <files />
        </sibling>
        <sibling>
            <folderkey>1idgyy8easr75</folderkey>
            <name>testst</name>
            <description />
            <tags />
            <created>2013-01-11 15:13:57</created>
            <privacy>public</privacy>
            <file_count>97</file_count>
            <revision>1</revision>
            <epoch>1361220901</epoch>
            <owner_name>Testbiz</owner_name>
            <avatar>https://secure.gravatar.com/avatar/00000000?s=27&d=mm&f=y</avatar>
            <dropbox_enabled>no</dropbox_enabled>
            <flag>2</flag>
            <folders />
            <files />
        </sibling>
    </siblings>
    <result>Success</result>
    <current_api_version>2.14</current_api_version>
</response>

Move


Description : Move one folder to another folder.

Required Parameters:


Optional Parameters:
  • signature : This is the call signature that is required to authenticate a type 2 session token transaction.
  • folder_key_dst : Call the folderkey that identifies the destination folder. If omitted, the destination folder will be the root folder (My Files).
  • response_format : 'xml' or 'json' (default 'xml')

GET http://www.mediafire.com/api/unversioned/folder/move.php
POST http://www.mediafire.com/api/unversioned/folder/move.php

Example:

Request 
http://www.mediafire.com/api/unversioned/folder/move.php?session_token=3f643fbbda95b7dfc4a094927a8bb23cde7bc64481f015eabca2559ae1835984c85566f97882e4c598e5702f556064e22bb9e8f6b9d12a67a7bd74e4bdd553c958e489572cd0d1fc&folder_key_src=bbm411lcts280&folder_key_dst=d2udzgjn5l5vd
Response 
<response>
    <action>folder/move</action>
    <myfiles_revision>
        <revision>5.0</revision>
        <epoch>1361220899</epoch>
    </myfiles_revision>
    <result>Success</result>
    <current_api_version>2.14</current_api_version>
</response>

Purge


Description : Permanently delete a user's folder.

Required Parameters:


Optional Parameters:
  • signature : This is the call signature that is required to authenticate a type 2 session token transaction.
  • response_format : 'xml' or 'json' (default 'xml')

GET http://www.mediafire.com/api/unversioned/folder/purge.php
POST http://www.mediafire.com/api/unversioned/folder/purge.php

Example:

Request 
http://www.mediafire.com/api/unversioned/folder/purge.php?session_token=3f643fbbda95b7dfc4a094927a8bb23cde7bc64481f015eabca2559ae1835984c85566f97882e4c598e5702f556064e22bb9e8f6b9d12a67a7bd74e4bdd553c958e489572cd0d1fc&folder_key=0dwzor67253tu
Response 
<response>
    <action>folder/delete</action>
    <myfiles_revision>
        <revision>2.0</revision>
        <epoch>1361220899</epoch>
    </myfiles_revision>
    <result>Success</result>
    <current_api_version>2.14</current_api_version>
</response>


Description : Searches the the content of a given folder. If folder_key is not passed, then the search will be performed on the root folder ("myfiles"). In this case, the session token will be required. To search the root folder on devices other than the cloud, pass the device_id. If device_id is '-1', then a global search on all devices will be performed.

Required Parameters:

  • search_text : The search keywords to look for in filenames, folder names, descriptions and tags.
  • folder_key : Identify the folderkey of the folder to search. If not passed, the session token is then required, and the search will be performed on the root folder or the entire device according to search_all parameter.
OR
  • session_token : A type 1 or type 2 session token. (Type 2 will require a call signature). Needed only when accessing root folder, private folder, or the folder's private content.

Optional Parameters:
  • signature : This is the call signature that is required to authenticate a type 2 session token transaction.
  • filter : filter by privacy and/or by filetype. This is a comma-separated list of file types and privacy options. Can take one or more of the following values : "public", "private", "image", "video", "audio", "document", "spreadsheet", "presentation", "application", "archive", "data", and "development".
  • device_id : Specify which device to return the myfiles data. If not set, it defaults to the cloud. If it's set to -1, then search will be performed on all devices.
  • search_all : 'yes' or 'no'. If folder_key is passed, then this parameter is ignored. If folder_key is not passed, search_all can be used to indicate whether to search the root folder only or the entire device (default 'yes').
  • details: "yes", "no", or "shallow" ("no" by default). If "yes", the API returns the '''total_files''', '''total_folders''', and '''total_size''' for all the contained folders and files recursively of each folder. However, there is a limit on how many items can be counted. If the limit is reached, an extra property '''overflow''' will be returned as well. If "shallow" is specified, the API returns the '''byte_count''' of files immediately inside each folder (non-recursive).
  • response_format : 'xml' or 'json' (default 'xml')

GET http://www.mediafire.com/api/unversioned/folder/search.php
POST http://www.mediafire.com/api/unversioned/folder/search.php

Example:

Request 
http://www.mediafire.com/api/unversioned/folder/search.php?session_token=c94078a5b36f6dad64924676be45407a4ae0d772525050d6b1d8215fbea7ec21ea1f7ac04f3366d0a22829a712bfc8bc13b9ee39a82d0ea1d161fe3442e0265da8e58058232bd14e&search_text=unicode
Response 
<response>
    <action>folder/search</action>
    <results_count>3</results_count>
    <results>
        <result>
            <type>file</type>
            <quickkey>a91a5j8ru2bcqdh</quickkey>
            <filename>unicode.txt</filename>
            <parent_folderkey>iie3pu4pvtaui</parent_folderkey>
            <parent_name>unicode</parent_name>
            <created>2013-07-01 10:50:02</created>
            <revision>22882</revision>
            <size>25582</size>
            <description/>
            <privacy>public</privacy>
            <password_protected>no</password_protected>
            <mimetype>text/plain</mimetype>
            <filetype>document</filetype>
            <view>1</view>
            <edit>1</edit>
            <hash>6c179f21e6f62b629055d8ab40f454ed02e48b68563913473b857d3638e23b28</hash>
            <flag>22</flag>
            <relevancy>100</relevancy>
        </result>
        <result>
            <type>folder</type>
            <folderkey>iie3pu4pvtaui</folderkey>
            <name>unicode</name>
            <parent_folderkey>m8zm361z1s810</parent_folderkey>
            <parent_name>Unicode Test</parent_name>
            <revision>22885</revision>
            <privacy>public</privacy>
            <relevancy>100</relevancy>
        </result>
        <result>
            <type>folder</type>
            <folderkey>m8zm361z1s810</folderkey>
            <name>Unicode Test</name>
            <parent_folderkey>3g9v11j8z8rd8</parent_folderkey>
            <parent_name>Search Test</parent_name>
            <revision>22886</revision>
            <privacy>public</privacy>
            <relevancy>100</relevancy>
        </result>
    </results>
    <result>Success</result>
    <current_api_version>2.14</current_api_version>
</response>

JSON Example:

Request 
http://www.mediafire.com/api/unversioned/folder/search.php?session_token=04ef99ba504d24b1f11371a2bb30bb127c5823ab894139daf97feb800d9b752e6b5e2cc98b6d27c8b37fe3912bb23912ec7f0759fad905d7b7a1bc42de77cb24deeac7c418c0d0c6&search_text=unicode&response_format=json
Response 
{
  "response": {
    "action": "folder\/search",
    "results_count": "3",
    "results": [
      {
        "type": "file",
        "quickkey": "a91a5j8ru2bcqdh",
        "filename": "unicode.txt",
        "parent_folderkey": "iie3pu4pvtaui",
        "parent_name": "unicode",
        "created": "2013-07-01 10:50:02",
        "revision": "22882",
        "size": "2",
        "description": "",
        "privacy": "public",
        "password_protected": "no",
        "mimetype": "text\/plain",
        "filetype": "document",
        "view": "1",
        "edit": "1",
        "hash": "6c179f21e6f62b629055d8ab40f454ed02e48b68563913473b857d3638e23b28",
        "flag": "22",
        "relevancy": "100"
      },
      {
        "type": "folder",
        "folderkey": "iie3pu4pvtaui",
        "name": "unicode",
        "parent_folderkey": "m8zm361z1s810",
        "parent_name": "Unicode Test",
        "revision": "22885",
        "privacy": "public",
        "relevancy": "100"
      },
      {
        "type": "folder",
        "folderkey": "m8zm361z1s810",
        "name": "Unicode Test",
        "parent_folderkey": "3g9v11j8z8rd8",
        "parent_name": "Search Test",
        "revision": "22886",
        "privacy": "public",
        "relevancy": "100"
      }
    ],
    "result": "Success",
    "current_api_version": "2.14"
  }
}

Set Flags


Deprecated. Use folder/update instead.

Description : Sets the bits in the folder's flags.

Required Parameters:

  • session_token : A type 1 or type 2 session token. (Type 2 will require a call signature).
  • folder_key : The key that identifies the folder. You can also specify multiple folderkeys separated by commas.
  • bit : The number of the bit to modify (starting from 0).
  • value : The value to set the above bit to. It can only take the value 0 or 1.

Optional Parameters:
  • signature : This is the call signature that is required to authenticate a type 2 session token transaction.
  • response_format : 'xml' or 'json' (default 'xml')

GET http://www.mediafire.com/api/unversioned/folder/set_flags.php
POST http://www.mediafire.com/api/unversioned/folder/set_flags.php

Example:

Request 
http://www.mediafire.com/api/unversioned/folder/set_flags.php?session_token=50adfd2c3ccb2246d8997840c54e986fbb8f5f445df069c5e474136640944272190551be7c816ed70bd4f4853a874e7df519987210dcd9daa160f61ef1841b9c7dda380bad84886b&folder_key=rae77xp6dy7za&bit=0&value=1
Response 
<response>
    <action>folder/set_flags</action>
    <device_revision>123</device_revision>
    <deprecated>yes</deprecated>
    <result>Success</result>
    <current_api_version>2.14</current_api_version>
</response>

Update


Description : Update a folder's information.

Required Parameters:


Optional Parameters:
  • signature : This is the call signature that is required to authenticate a type 2 session token transaction.
  • foldername : The name of the folder.
  • description : The description of the folder.
  • privacy : Privacy of the folder ('public' or 'private').
  • privacy_recursive : Whether or not applying 'privacy' to sub-folders - 'yes' or 'no' (default 'no').
  • mtime : The date/time of the folder's creation. If not set, the current server time will be used. Refer to the following document for valid date/time formats: http://www.php.net/manual/en/datetime.formats.php
  • tags : A space-separated list of tags. Deprecated. Do Not Use.
  • note_subject: The subject of the folder's note. Deprecated. Do Not Use.
  • note_description: The description of the folder's note. Deprecated. Do Not Use.
  • response_format : 'xml' or 'json' (default 'xml')

GET http://www.mediafire.com/api/unversioned/folder/update.php
POST http://www.mediafire.com/api/unversioned/folder/update.php

Example:

Request 
http://www.mediafire.com/api/unversioned/folder/set_flags.php?session_token=50adfd2c3ccb2246d8997840c54e986fbb8f5f445df069c5e474136640944272190551be7c816ed70bd4f4853a874e7df519987210dcd9daa160f61ef1841b9c7dda380bad84886b&folder_key=rae77xp6dy7za&bit=0&value=1http://www.mediafire.com/api/unversioned/folder/update.php?session_token=3f643fbbda95b7dfc4a094927a8bb23cde7bc64481f015eabca2559ae1835984c85566f97882e4c598e5702f556064e22bb9e8f6b9d12a67a7bd74e4bdd553c958e489572cd0d1fc&folder_key=8adbweycihdkd&foldername=new_name&description=new_desc&privacy=private
Response 
<response>
    <action>folder/update</action>
    <myfiles_revision>
        <revision>8.0</revision>
        <epoch>1361220899</epoch>
    </myfiles_revision>
    <device_revision>123</device_revision&gr;
    <result>Success</result>
    <current_api_version>2.14</current_api_version>
</response>