This call returns a list of tasks that you can access.
If you are using Seven Bridges Platform EU, please use the following endpoint:
https://eu-api.sbgenomics.com/v2/tasks
Using the timestamps
The parameters created_from
, created_to
, started_from
, started_to
, ended_from
and ended_to
are timestamp parameters.
They can be used to query tasks that were created, started, or ended during a specified time interval. All query parameters can be combined.
For example, querying https://api.sbgenomics.com/v2/tasks?fields=_all&started_from=2016-12-26T12:46:25&ended_to=2016-12-28 will return all tasks which ran between December 26, 2016 at 12:46:25 and December 28.
Furthermore, the timestamp query parameters can be combined with other query parameters. For example, querying https://api.sbgenomics.com/v2/tasks?fields=_all&created_from=2016-12-26T12:46:25&status=FAILED will return all tasks which were created from December 26 onwards and have failed.
Date format
All dates should be entered using the UTC format (ISO 8601). Allowed formats are:
- T<HH:mm:ss>+/-<HH:mm> (use this format to specify the UTC offset, see below)
- yyyy-MM-ddTHH:mm:ss
- yyyy-MM-dd (when this format is used, the implicit time is 00:00:00)
Parameter | Description |
---|---|
yyyy | 4 digits for the year (e.g. 2017) |
T | special character followed by hours and minutes |
ss | 2 digits for seconds (e.g. "25) |
MM | 2 digits for a month (e.g. "02" for February) |
mm | 2 digits for minutes (e.g. "45") |
HH | 2 digits for an hour (e.g. "23") |
dd | 2 digits for a day (e.g. "01") |
- | UTC - hh:mm |
+ | UTC + hh:mm |
UTC offset (HH:mm)
The hours and minutes should be entered the same way as for the date but are used to specify the time offset (e.g. -05:00 = UTC-5). This means you can use your local time to query but have to specify the UTC offset.
Examples:
- 2016-04-01T14:25:50+01:00 - Fri Apr 01 13:25:50 UTC 2016
- 2016-04-01T14:25:50 - Fri Apr 01 14:25:50 UTC 2016
- 2016-04-01 - Fri Apr 01 00:00:00 UTC 2016