Algorithmia (version v1.*.*)

call_algorithm#

call any Algorithm found at http://algorithmia.com/algorithms

Parameters

algorithm (required)#

Name of the algorithm. If a specific version is required, specify as "{algorithm}/{version}", where version is in the format "1.x.x" and "x" can be the wildcard "*".

Type: string

user (required)#

username of the algorithm

Type: string

$body#

see sample input for the specific Algorithm from http://algorithmia.com/algorithms

Type: string

output#

If "raw", returns the result of the algorithm call without the JSON-RPC wrapper. If the algorithm returned an error then an HTTP 400 status code will be used. If "void", returns immediately and does not wait for the algorithm to run. The result of the algorithm will not be accessible; this is useful in some cases where an algorithm outputs to a data:// file with a long running time.

Type: string

Potential values: raw, void

stdout#

Indicates algorithm stdout should be returned in the response metadata (ignored unless you are the algorithm owner)

Type: boolean

timeout#

Specifies a timeout for the call in seconds.

Type: number

create_directory#

Create a new directory with the specified path as the parent directory.

Parameters

connector (required)#

The data source: data, dropbox, s3, or a labeled variant (e.g. dropbox+mylabel).

Type: string

path (required)#

The path, relative to the root of a given data source.

Type: string

$body#

Type: object

{
"name" : "Name of the directory to create",
"acl" : {
"read" : [ "string" ]
}
}

delete_object#

Delete a specified directory or file.

Parameters

connector (required)#

The data source: data, dropbox, s3, or a labeled variant (e.g. dropbox+mylabel).

Type: string

path (required)#

The path, relative to the root of a given data source.

Type: string

force#

If true, enables recursive delete of a non-empty directory

Type: boolean

list_path#

This operation either lists the contents of a directory, if a directory is specified in the path, or gets a file. If you aren’t sure if a path refers to a file or directory, you should first check if it exists. The exists methods make a HEAD request that check the X-Data-Type response header.

Parameters

connector (required)#

The data source: data, dropbox, s3, or a labeled variant (e.g. dropbox+mylabel).

Type: string

path (required)#

The path, relative to the root of a given data source.

Type: string

acl#

Include the directory ACL in the response.

Type: boolean

marker#

Indicates the page of results to return. Only valid when using markers previously returned by this API. If this parameter is omitted then the first page is returned.

Type: string

update_directory#

Update specified directory's ACL.

Parameters

connector (required)#

The data source: data, dropbox, s3, or a labeled variant (e.g. dropbox+mylabel).

Type: string

path (required)#

The path, relative to the root of a given data source.

Type: string

$body#

Type: object

{
"acl" : {
"read" : [ "string" ]
}
}

upload_file#

Upload a file through the Algorithmia Data API.

Parameters

connector (required)#

The data source: data, dropbox, s3, or a labeled variant (e.g. dropbox+mylabel).

Type: string

path (required)#

The path, relative to the root of a given data source.

Type: string

$body#

Type: string