Partek Flow Documentation

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

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 27 Next »

Structure of the URI

http://example.com:8080/flow/api/v1

Authentication

The username and access token must be supplied unless the request is made in an authenticated session.

The access token can be generated from the settings page or using the public key included in the PartekFlow-REST.zip as described in REST API

Servlets

/servlets

since 7.0.180726

GET

An up-to-date form of this documentation

ParameterTypeDescriptionDefault
formatstringmarkup: confluence markupjson

 

Projects

/projects

since 7.0.18.0125

PUT, POST

Add or configure a project

Parameter

Type

Description

project_id or project

integer or string

A project specification

owner

string

Sets the project owner

name

string

Sets the project name

description

string

Sets the project description

collaborator

string

If this parameter is specified, then “role” must also be specified. If the role parameter is “remove” then the specified collaborator is removed from the project, otherwise role must be a valid project role (Collaborator or Viewer).

my_output_folder

string

Sets the project output folder for the user making the request

output_folder

string

Sets the project output folder for all collaborators the user making the request has permission to affect

/projects

since 7.0.17.0803

DELETE

Delete projects

Parameter

Type

Description

project_id or project

integer or string

A project specification

/projects

since 7.0.17.0524

GET

Returns metadata about a project

/projects/error

since 7.0.18.0802

PUT, GET, POST

Get or set a project-specific error message

Parameter

Type

Description

project_id or project

integer or string

A project specification

message

String

 

/projects/export

since 7.0.16.1101

PUT, GET, POST

Export a specified project to a .zip file

Parameter

Type

Description

Default

project_ids

comma-delimited integers

A specification for one or more projects

 

includeLibraryFiles

boolean

If equal to true then library files will be included

 

outputFolder

String

A path on the server to write the exported projects to.

Stream the project(s) to the requestor

/projects/files

since 7.0.17.1101

PUT, GET, POST

Returns files associated with projects

/projects/folders

since 7.0.17.1101

PUT, GET, POST

Returns folders associated with projects

Parameter

Type

Description

project_ids

string

Retrieve specific projects. IDs joined by ,

project_id

integer

Retrieve a single project by ID

project

string

Retrieve a single project by name

sample

string

List projects that contain a sample with the specified name

file_name

string

List projects that contain a file matching the specified sub-string

user_id

integer

List projects for which the specified user is a member

user_name

string

List projects for which the specified user is a member

/projects/import

since 7.0.16.1101

PUT, GET, POST

Import a project from an exported .zip file

Parameter

Type

Description

Default

url or filepath or file

string or string or binary

The location of a project zip: on a remote server or on the specified server or in the stream

 

owner_id or owner_name

integer or string

This user will be the owner of the imported project

By default, the user making the API request will be the owner

/projects/list

since 7.0.17.1101

PUT, GET, POST

Returns a list of projects available on the server

Parameter

Type

Description

project_ids

string

Retrieve specific projects. IDs joined by ,

project_id

integer

Retrieve a single project by ID

project

string

Retrieve a single project by name

sample

string

List projects that contain a sample with the specified name

file_name

string

List projects that contain a file matching the specified sub-string

user_id

integer

List projects for which the specified user is a member

user_name

string

List projects for which the specified user is a member

/projects/output_folders

since 7.0.17.1101

PUT, GET, POST

Returns the output folders for projects

Parameter

Type

Description

project_ids

string

Retrieve specific projects. IDs joined by ,

project_id

integer

Retrieve a single project by ID

project

string

Retrieve a single project by name

sample

string

List projects that contain a sample with the specified name

file_name

string

List projects that contain a file matching the specified sub-string

user_id

integer

List projects for which the specified user is a member

user_name

string

List projects for which the specified user is a member

/projects/properties

since 7.0.18.0529

PUT, GET, POST

List or configure project-specific properties

Parameter

Type

Description

key

String

The name of the property

value

String

The value of the property

/projects/report

since 7.0.18.0902

PUT, GET, POST

Generates a tab-delimited report on tasks in a project

Parameter

Type

Description

project_id or project

integer or string

A project specification

/projects/resources

since 7.0.18.0910

PUT, GET, POST

Returns meta-data on resources associated with the project

Parameter

Type

Description

project_id or project

integer or string

A project specification

/projects/samples

since 7.0.17.1101

PUT, GET, POST

List samples associated with projects

Parameter

Type

Description

project_ids

string

Retrieve specific projects. IDs joined by ,

project_id

integer

Retrieve a single project by ID

project

string

Retrieve a single project by name

sample

string

List projects that contain a sample with the specified name

file_name

string

List projects that contain a file matching the specified sub-string

user_id

integer

List projects for which the specified user is a member

user_name

string

List projects for which the specified user is a member

/projects/search

since 7.0.18.0529

PUT, GET, POST

Search for projects

/projects/status

since 7.0.18.0819

PUT, GET, POST

Get or set project statuses

Parameter

Type

Description

project_id

integer

 

importing

String

 

Samples

/samples

since 7.0.17.0921

PUT, POST

Import a set of attributes

Parameter

Type

Description

attribute_json

String

A set of attributes in the same format as returned by /samples/attributes

attribute_txt

String

A set of attributes in a tab-delimited file

sample_id or sample_name

integer or string

A sample specification

(attribute or numeric_attribute) and value

String

 

/samples

since 7.0.17.0921

PUT, GET, POST

Add or query a sample

Parameter

Type

Description

project_id or project

integer or string

A project specification

sample_id or sample_name

integer or string

A sample specification

/samples/attributes

since 7.0.17.0915

PUT, GET, POST

Returns attributes associated with a sample

/samples/list

since 7.0.17.0921

PUT, GET, POST

Returns samples and attributes in a specified project

Parameter

Type

Description

project_id or project

integer or string

A project specification

Data

/data

since 7.0.18.0110

PUT, GET, POST

Upload data to the server

Parameter

Type

Description

Default

project_id or project

integer or string

A project specification

 

filepath and/or filepath1 and/or filepath2

String

The location of the file on the server. Up to three files can by imported at once.

 

sample_id or sample or new_sample

integer string string

The id or name of the sample to add data to. If new_sample is specified and the sample already exists characters will be added to disambiguate the new sample

 

owner

string

The username of the user that should be the owner of the data. The data will count against this user’s quota, if one is configured.

The owner will be the user account that uploads the data

upload_folder

string

If the file is uploaded through the servlet it will be put in this directory, if the owner has permission to access it.

 

/data/attributes

since 7.0.18.0110

PUT, GET, POST

Returns attributes associated with a resource

Parameter

Type

Description

resource_id

integer

A resource ID

/data/files

since 7.0.18.0830

PUT, GET, POST

Returns the list of files associated with a resource

Parameter

Type

Description

resource_id

integer

A resource ID

/data/managed

since 7.0.17.0817

PUT, GET, POST

Returns unmanaged files in a given directory

Parameter

Type

Description

directory

String

 

/data/reassign

since 7.0.18.0710

PUT, GET, POST

Repair links to data that has changed directories

Parameter

Type

Description

former

String

Old path to the data

current

String

New path to the data

/data/table

since 7.0.18.1120

PUT, GET, POST

Exports a task result table

Parameter

Type

Description

Default

task_id

integer

The ID of the task that produced the table

 

table

String

The table to download, if ambiguous for the task.
QuantificationSummary, TranscriptQuantificationSummary, GeneQuantificationSummary, transcript_feature_distribution, gene_feature_distribution

QuantificationSummary

/data/unmanaged

since 7.0.17.0817

PUT, GET, POST

Returns unmanaged files in a given directory

Parameter

Type

Description

directory

String

 

Library files

/library_files

since 7.0.16.0826

PUT, GET, POST

Imports a library file

Parameter

Type

Description

file or filepath

binary or string

The file content or the path of the file on the server

file_type

String

The type of library file. The list of available library file types is returned by /library_files/types

assembly

String

The assembly of the library file

species

string

The species of the library file. This is looked up based on the assembly, and the assembly is used as the species if the assembly is not associated with any species

/library_files/build

since 7.0.18.0207

PUT, GET, POST

Build a library file derived from an existing managed file

/library_files/files

since 7.0.17.0921

PUT, GET, POST

Returns metadata (including file paths) for managed library files

/library_files/list

since 7.0.17.0915

PUT, GET, POST

Returns metadata for managed library files

Parameter

Type

Description

file_type

String

Filters results based on file type

annotation_model

String

Filters results based on annotation model

descriptions

String

Filters results based on the description

id

String

Return a result for a specific library file

/library_files/snp_eff

since 7.0.18.0619

PUT, GET, POST

Loads a manually downloaded SnpEff database. A SnpEff bin file must be present on the server under library files assembly/database/SnpEff database/database

Parameter

Type

Description

genome_build

String

 

database

String

 

/library_files/types

since 7.0.17.0915

PUT, GET, POST

Returns available library file types

Pipelines

/pipelines

since 7.0.17.0921

PUT, GET, POST

Download the specified pipeline specification

Parameter

Type

Description

pipeline

String

The name of the pipeline

/pipelines/inputs

since 7.0.17.0921

PUT, GET, POST

List the inputs required by the specified pipeline

Parameter

Type

Description

Default

pipeline

String

The name of the pipeline

 

project_id or project

integer or string

A project specification

 

data

String

The data node that the pipeline will run on, as returned by the /projects interface.

Unaligned reads

/pipelines/list

since 7.0.17.0921

PUT, GET, POST

Returns pipelines available on the server

/pipelines/run

since 7.0.17.0921

PUT, GET, POST

Run the specified pipeline

Parameter

Type

Description

Default

pipeline

String

The name of the pipeline

 

project_id or project

integer or string

A project specification

 

inputs

integers

The ids of the resources, in the order returned by the /pipeline/inputs interface. The ids of library files are returned by the /library_files interface.

 

data

String

The data node that the pipeline will run on, as returned by the /projects interface.

Unaligned reads

Queue

/queue

since 7.0.17.0901

PUT, GET, POST

Returns summary statistics of the task queue

Parameter

Type

Description

project or project_name or project_filter

string

Only return tasks in this project

project_id

integer

Only return tasks in this project

user_name or user_filter

string

Only return tasks run by this user

user_id

integer

Only return tasks run by this user

status

string

Only return tasks matching this status

/queue/cancel

since 7.0.17.0901

PUT, POST

Cancel tasks in progress

Parameter

Type

Description

project or project_name or project_filter

string

Only return tasks in this project

project_id

integer

Only return tasks in this project

user_name or user_filter

string

Only return tasks run by this user

user_id

integer

Only return tasks run by this user

status

string

Only return tasks matching this status

/queue/commands

since 7.0.17.0901

PUT, GET, POST

Returns information about queued commands

/queue/downloads

since 7.0.17.0901

PUT, GET, POST

Returns the count of downloads in progress

/queue/tasks

since 7.0.17.0901

PUT, GET, POST

Returns information about tasks in the queue

Parameter

Type

Description

project or project_name or project_filter

string

Only return tasks in this project

project_id

integer

Only return tasks in this project

user_name or user_filter

string

Only return tasks run by this user

user_id

integer

Only return tasks run by this user

status

string

Only return tasks matching this status

Users

/users

since 7.0.17.0901

PUT, POST

Add or configure users

Parameter

Type

Description

Default

user_id or user_name

integer or string

A user specification. If user_name is specified the account will be created if it does not already exist

If this is not specified, the configuration will apply to the user making the request

distinguished_name

string

When creating a new user, this parameter specifies the LDAP distinguished name.

 

user_password

string

When creating a new user, this parameter specifies their initial Flow password. If this parameter is absent and this is not an LDAP user then the user will receive an email with a link to set their initial password.

 

email

string

The user’s email address. When creating a new user, this parameter is required.

 

display_name

string

The name that other users will see.

 

enabled

boolean

Whether the user is able to log in

 

add_role_name or add_role_id

string or integer

Add the user to the specified role

 

remove_role_name or remove_role_id

string or integer

Remove the user from the specified role

 

private_directory

string

If present, the directory will be created and the user will be given permission to use it.

 

add_directory

string

Add permission for the user to browse files in this directory.

 

quota

integer

The size of the user’s quota (in gigabytes) or “none” to remove any quota

 

notify_when_tasks_finish

boolean

Whether the user will receive an email when a task they have queued completes

 

notify_when_added_to_project

boolean

Whether the user will receive an email when they are added as a collaborator or viewer to a project

 

decimal_precision

integer

How many digits to show after the decimal point for numeric values in tables

 

/users

since 7.0.17.0901

GET

Returns information about a user

Parameter

Type

Description

Default

user_id or user_name

integer or string

A user specification.

If this is not specified, the user making the request will be used

/users/list

since 7.0.17.0901

PUT, GET, POST

Returns a list of known users

/users/logins

since 7.0.18.0102

PUT, GET, POST

Returns a list of logged in users and their last activity

/users/preferences

since 7.0.18.0912

PUT, GET, POST

Get and set user preferences

Parameter

Type

Description

key

String

The name of the preference

value

String

The value of the preference

/users/roles

since 7.0.18.0323

PUT, GET, POST

Returns a list of roles assigned to users

/users/unset_private_directory

since 7.0.17.1011

PUT, POST

Configures the specified user to no longer use a private directory, instead reverting to the server defaults

Parameter

Type

Description

Default

user_id or user_name

integer or string

A user specification.

If this is not specified, the user making the request will be used

Roles

/roles

since 7.0.18.0710

PUT, GET, POST

Apply roles to users

/roles

since 7.0.18.0710

DELETE

Remove roles from users

/roles/list

since 7.0.18.0710

PUT, GET, POST

Returns a list of roles available on the server

/roles/privileges

since 7.0.18.0710

PUT, GET, POST

Returns a list of privileges available on the server

Permission

/permission

since 7.0.18.0213

PUT, GET, POST

Get or set enforcement of directory permissions

Parameter

Type

Description

enforce

boolean

 

/permission/add_directory

since 7.0.18.0213

PUT, GET, POST

Add permission to access a directory to a specified user

Parameter

Type

Description

Default

directory

String

 

 

user_id or user_name or group_id or group_name

integer or string or integer or string

A member specification

If a user or group is not specified, this action will apply to all users

/permission/remove_directory

since 7.0.18.0213

PUT, GET, POST

Remove permission to access a directory from a specified user

Parameter

Type

Description

Default

directory

String

 

 

user_id or user_name or group_id or group_name

integer or string or integer or string

A member specification

If a user or group is not specified, this action will apply to all users

Tasks

/tasks

since 7.0.18.0207

DELETE

Deletes tasks

Parameter

Type

Description

Default

id

integer

 

 

keep_output

boolean

 

false

/tasks

since 7.0.17.0207

PUT, GET, POST

Returns information about tasks that have run on the server

Parameter

Type

Description

project_id or project

integer or string

A project specification

id

integer

A single task ID

user_name or user_id

string or integer

The username or ID of a user that has run tasks

status

String

A task status: Pending, Waiting, Running, Done, Canceled, Failed

task

String

A sub-string of the task name & version as it appears in the Task entry on the task details page

/tasks/license

since 7.0.18.0920

PUT, GET, POST

Returns a list of available tasks and their license requirements

/tasks/logs

since 7.0.18.0930

PUT, GET, POST

Returns task logs

Parameter

Type

Description

project_id or project

integer or string

A project specification

id

integer

A single task ID

user_name or user_id

string or integer

The username or ID of a user that has run tasks

status

String

A task status: Pending, Waiting, Running, Done, Canceled, Failed

task

String

A sub-string of the task name & version as it appears in the Task entry on the task details page

/tasks/outputs

since 7.0.18.1120

PUT, GET, POST

Returns task output resource IDs and descriptions

/tasks/specs

since 7.0.18.0207

PUT, GET, POST

Returns a list of task test specifications

Filters

/filters

since 7.0.18.0207

PUT, GET, POST

Upload feature filters

Parameter

Type

Description

filepath or filter

String

filepath: a file on the server with filter content or filter: the filter content in json format

Commands

/commands

since 7.0.17.0901

PUT, GET, POST

Returns information about commands that have run on the server

Parameter

Type

Description

task

integer

Filter commands to those belonging to the specified task ID

worker_identifier

integer

Filter commands to those run on the specified worker

successful

boolean

Filter commands based on whether they successfully completed

command_line

String

Filter commands based on their command-line representation

/commands/description

since 7.0.17.0901

PUT, GET, POST

Returns a description of commands that have run on the server

/commands/fit

since 7.0.17.0901

PUT, GET, POST

Returns information about command fits

/commands/memory

since 7.0.17.0901

PUT, GET, POST

Returns the memory used by commands

Parameter

Type

Description

id

String

A specific command identifier

task

integer

Filter results based on a task ID

command

String

Filter results based on the command

conservative

boolean

Include/exclude results based on whether they are flagged as conservative

/commands/prediction

since 7.0.17.0901

PUT, GET, POST

Returns the predicted utilization of commands

/commands/report

since 7.0.18.0902

PUT, GET, POST

Generates a tab-delimited report on commands in a task

License

/license

since 7.0.17.0314

PUT, GET, POST

Returns information about license available on the server

Parameter

Type

Description

feature

String

Filters results based on feature name

Workers

/workers

since 7.0.17.0901

PUT, GET, POST

Returns a load summary of all connected workers

/workers/count

since 7.0.17.0901

PUT, GET, POST

Returns the number of connected workers

/workers/internal

since 7.0.17.0901

PUT, GET, POST

Returns a load summary of the internal worker, if it is enabled

/workers/remote

since 7.0.17.0901

PUT, GET, POST

Returns a summary of the load of remote workers

/workers/submitted

since 18.0930

PUT, GET, POST

Get and set information about workers that have been submitted to a cluster, but may not yet have connected

Parameter

Type

Description

submitted_workers

integer

 

max_memory_mb

integer

 

System

/system

since 7.0.17.0227

PUT, GET, POST

Get and set page load log threshold

Parameter

Type

Description

page_load_log_threshold

integer

If specified and greater than 0 a warning will be written to logs/page_load.log whenever a page-load takes longer than this value (in seconds)

/system/generate_token

since 7.0.18.1020

PUT, GET, POST

Generate an access token for the requesting user

Parameter

Type

Description

Default

expiration

String

never for no expiration, otherwise: d-M-yyyy h:mm a

 

duration

integer

duration of the token, in hours

1 hour

/system/import

since 7.0.18.0228

PUT, POST

Import a set of server preferences from a json specification

/system/logging

since 7.0.17.1024

PUT, GET, POST

Configure log levels

Parameter

Type

Description

logger

string

The name of a logger or "commands" to configure multiple command-related logs.

log_level

string

Sets the level of the specified logger: ALL, TRACE, DEBUG, INFO, WARN, ERROR, OFF

/system/preferences

since 7.0.18.0130

DELETE

Delete preferences, reverting the values to default

Parameter

Type

Description

node

String

Required unless deleting from the root node

key

String

The ID of the preference to delete

/system/preferences

since 7.0.18.0130

PUT, GET, POST

Get and set system preferences

Parameter

Type

Description

node

string

The node name

key

string

The preference name

value

string

The preference value

/system/preferences/nodes

since 7.0.18.0130

PUT, GET, POST

Returns a list of preference node names

/system/revoke

since 7.0.18.1020

PUT, GET, POST

Revoke API access tokens

Parameter

Type

Description

api_key

String

An API token to revoke. "mine" to revoke the requestors tokens, "all" to revoke all managed tokens (requires Change user accounts privilege)

/system/token

since 18.07.0930

PUT, GET, POST

Manage access tokens

Parameter

Type

Description

Default

api_key

String

The token to configure

Return a list of all tokens managed for the requestor

expiration

String

never for no expiration, otherwise: d-M-yyyy h:mm a

 

/system/token/list

since 7.0.18.1020

PUT, GET, POST

Lists all managed tokens (Requires View user accounts privilege)

Additional Assistance

If you need additional assistance, please visit our support page to submit a help ticket or find phone numbers for regional support.

Your Rating: Results: 1 Star2 Star3 Star4 Star5 Star 0 rates

 

  • No labels