List tasks in a project (secondary method)

/projects/{project_owner}/{project}/tasks

This call lists the tasks in the specified project. It is an alias for the call GET tasks and redirects to that path.

Path

https://api.sb.biodatacatalyst.nhlbi.nih.gov/v2/projects/{project_owner}/{project}/tasks

❗️

Alias call

Note that since this is an alias for another call, the call cannot be made straightforwardly from all applications. In particular, to send the call using cURL, use the cURL option -L to redirect the path of this call to https:/api.sb.biodatacatalyst.nhlbi.nih.gov/v2/files?project={project_owner}/{project.

Alternatively, to list all files, you can simply use the call GET tasks.

Request

Example request

👍

Referring to your project

Note that project_owner is always case-sensitive, and that project is not the project's name but its ID, or short name. For full details of identifying objects using the API, please see the API overview.

HTTP

GET /v2/projects/RFranklin/my-project/tasks HTTP/1.1
Host: api.sb.biodatacatalyst.nhlbi.nih.gov
X-SBG-Auth-Token: 3259c50e1ac5426ea8f1273259740f74

cURL

curl -L "https://api.sb.biodatacatalyst.nhlbi.nih.gov/v2/tasks?project=RFranklin/my-project"  -s -H "X-SBG-Auth-Token: 7942f56901534434a054dafc3813bc96" -H "content-type: application/json" -X GET "https://api.sb.biodatacatalyst.nhlbi.nih.gov/v2/projects/RFranklin/my-project/tasks"

Header Fields

Name	Description
X-SBG-Auth-Token required	Your authentication token.

Path parameters

Name	Description
project	The short name of the project you are querying.
project_owner	The owner of the project you are querying.

Query parameters

Name	Data type	Description
fields	string	Selector specifying a subset of fields to include in the response.

Response

See a list of response codes that may be contained in the body of the response.

Example response body

JSON

{
  "href": "https://api.sb.biodatacatalyst.nhlbi.nih.gov/v2/tasks?offset=0&limit=25&project=RFranklin/my-project",
  "items": [
    {
      "href": "https://api.sb.biodatacatalyst.nhlbi.nih.gov/v2/tasks/39bc3e8c-6cf6-4f8f-b550-21e9633c1f4b",
      "id": "39bc3e8c-6cf6-4f8f-b550-21e9633c1f4b",
      "name": "test run - 12-11-15 11:02:03",
      "project": "RFranklin/my-project"
    },
    {
      "href": "https://api.sb.biodatacatalyst.nhlbi.nih.gov/v2/tasks48f79ccf-12b3-45b6-789c-b1e8d88dabcd",
      "id": "48f79ccf-12b3-45b6-789c-b1e8d88dabcd",
      "name": "test run - 12-11-15 11:52:45",
      "project": "RFranklin/my-project"
    }
  ],
  "links": []
}
{
  "href": "https://api.sb.biodatacatalyst.nhlbi.nih.gov/v2/tasks/?offset=0&limit=25&project=RFranklin/my-project",
  "items": [
    {
      "href": "https://api.sb.biodatacatalyst.nhlbi.nih.gov/v2/tasks/1fd125fa-789c-45b6-12b3-2a3ab3bedcba",
      "id": "1fd125fa-789c-45b6-12b3-2a3ab3bedcba",
      "name": "test run - 12-11-15 11:02:03",
      "project": "RFranklin/my-project"
    },
    {
      "href": "https://api.sb.biodatacatalyst.nhlbi.nih.gov/v2/tasks/f0b89de2-45b6-789c-12b3-05b832c576c6",
      "id": "f0b89de2-45b6-789c-12b3-05b832c576c6",
      "name": "test run - 12-11-15 11:52:45",
      "project": "RFranklin/my-project"
    }
  ],
  "links": []
}