Page tree
Skip to end of metadata
Go to start of metadata

Last updated: Dec 15, 2019 11:57

Uploads the item in the body of the request to the location specified by <repositoryItemKey> in the repository area specified by <repository>.

This operation only supports the POST HTTP method. The item being uploaded is specified as the body of the request. 

Syntax

https://mycloud.perfectomobile.com/services/repositories/<repository>/<repositoryItemKey>?operation=upload&securityToken=value[&optionalParameter=value]

Note: All REST API commands require authentication, see the general authentication methods here.

Parameters

NameTypeDefaultDescription
securityToken*string
A unique cryptographic key assigned to an authorized user.
admin boolean falsetrue to allow users with administrative credentials to upload items to private repository of other automation users.
owner string 
The user name of the user who owns the item. This parameter is used in conjunction with the admin parameter to correctly identify items to be stored in PRIVATE or GROUP repositories of the owner. For example, if a user with administrative credentials wants to upload an item where the repositoryItemKey is PRIVATE:myItem.jpg orGROUP:myItem.jpg, specify the parameters as admin=true and owner=itemUser
group string 
The group name. This parameter is used in conjunction with the admin parameter to correctly identify items to be stored in GROUP repositories. For example, if a user with administrative credentials wants to upload an item where the repositoryItemKey isGROUP:myItem.jpg , specify the parameters as admin=true and group= groupName. 
property.<name>boolean 
The name and value of one or more a repository properties, each prefixed with property. For example, to specify an integer property called readonly with the value true, add property.readonly=true to the URL. 
overwriteboolean falsetrue to overwrite existing files.
formatstring 
The format of the file. This option only applies when uploading data tables. Possible values: xml, csv 
responseFormatstring jsonFormat of response: json, xml

Response

NameDescription
statussuccess if the operation completed successfully; otherwise failure.



For usage examples, see Using the REST API.