API ReferenceTasks
List tasks
Lists the workspace's tasks, from every source, most recently active first.
To get the next page, pass nextCursor back as cursor. Treat the cursor as opaque. nextCursor is null on the last page.
GET
/v1/workspaces/{workspaceId}/tasksAuthorizationBearer <token>
A personal access token, which starts with sntr_. Create one on the dashboard's CLI & API page (https://app.sinatra.dev/tokens). It acts as you in every workspace you belong to, with your role in each, and expires after at most 365 days. The CLI's browser sign-in sends an OAuth access token here instead.
In: header
Path Parameters
workspaceIdstring
The workspace's id, from GET /v1/me.
Query Parameters
status?string
Only tasks in this status, such as implementing or pr_open. A name that isn't a task status is invalid_status.
limit?integer
How many tasks to return, 1 to 100.
Default
50Range
1 <= value <= 100cursor?string
nextCursor from the previous page. Treat it as opaque.
Response Body
curl -X GET "https://api.sinatra.dev/v1/workspaces/string/tasks?status=string&limit=50&cursor=string"{
"tasks": [
{
"id": "string",
"status": "string",
"source": "string",
"title": "string",
"repo": "string",
"pullRequest": {
"url": "string",
"merged": true
},
"queued": true,
"createdAt": "2019-08-24T14:15:22Z",
"lastActivityAt": "2019-08-24T14:15:22Z",
"url": "string"
}
],
"nextCursor": "string"
}{
"error": "string",
"reason": "string",
"requestId": "string",
"refusal": "string",
"billingUrl": "string",
"settingsUrl": "string",
"plan": "string",
"running": 0,
"queued": 0,
"taskId": "string",
"messageId": "string"
}{
"error": "string",
"reason": "string",
"requestId": "string",
"refusal": "string",
"billingUrl": "string",
"settingsUrl": "string",
"plan": "string",
"running": 0,
"queued": 0,
"taskId": "string",
"messageId": "string"
}{
"error": "string",
"reason": "string",
"requestId": "string",
"refusal": "string",
"billingUrl": "string",
"settingsUrl": "string",
"plan": "string",
"running": 0,
"queued": 0,
"taskId": "string",
"messageId": "string"
}{
"error": "string",
"reason": "string",
"requestId": "string",
"refusal": "string",
"billingUrl": "string",
"settingsUrl": "string",
"plan": "string",
"running": 0,
"queued": 0,
"taskId": "string",
"messageId": "string"
}{
"error": "string",
"reason": "string",
"requestId": "string",
"refusal": "string",
"billingUrl": "string",
"settingsUrl": "string",
"plan": "string",
"running": 0,
"queued": 0,
"taskId": "string",
"messageId": "string"
}