Docs

List tasks

Preview· P9
GET
/tasks

Returns tasks in shared lists, soonest due first, by cursor. Nothing personal, confidential or from a protected source is ever here, whatever the key's scopes.

Scope: tasks:read

Authorization

headerAuthorizationBearer <token>

Send Authorization: Bearer <token> on every request. The token is one of:

PrefixWhat it isWhere it may be used
agoo_sk_live_Secret key, live modeYour servers only
agoo_sk_test_Secret key, test modeYour servers only
agoo_pk_live_Publishable key, live modeBrowsers and apps: create pre-registrations and bookings, read public booking types (with their intake questions) and their free slots, read the visit types open for pre-registration with their public forms. Never lists people.
agoo_pk_test_Publishable key, test modeAs above, in test mode
agoo_rk_live_Agoo Reviews key, live mode: a business on Agoo Reviews on its own, on Reviews BusinessYour servers only: the Reviews operations, for that business and the branches the key names
agoo_rk_test_Agoo Reviews key, test modeAs above, on any level: it reads the business's reviews and checks every write without saving it
agoo_ck_live_Check API key, live mode, for a Check API partnerYour servers only: the Checks operations (checks:read), billed per check
agoo_ck_test_Check API key, test modeAs above, answering only the published test values, never billed

Admins create keys in Console → Developers → API keys and choose each key's scopes; a business on Agoo Reviews on its own creates its keys in its business area on agoo.reviews, under Developers; a Check API partner creates its keys in its partner area on agoo.reviews. A key is shown once. Never put a secret key in a URL, a browser or a mobile app.

Scope: tasks:read

Query Parameters

limit?integer

How many items to return, from 1 to 100.

Range1 <= value <= 100
Default25
cursor?string

The next_cursor from the previous page. Leave it out for the first page.

Lengthlength <= 512
sort?string

Soonest due first, or newest first.

Default"due"
Value in"due""newest"
owner?string

Only tasks this person has.

Match^person_[0-7][0-9a-hjkmnp-tv-z]{25}$
Example"person_01kjsesxm0e4zbyvkr7bcfxbfg"
contributor?string

Only tasks this person helps with.

Match^person_[0-7][0-9a-hjkmnp-tv-z]{25}$
Example"person_01kjsesxm0e4zbyvkr7bcfxbfg"
container?string

Only tasks in this list.

triage?boolean

Only tasks nobody has yet.

due_from?string

Due on or after this day.

Formatdate
due_to?string

Due on or before this day.

Formatdate
status?string

Categories, separated by commas.

priority?string

Priorities, separated by commas.

source?string

Only tasks from this source.

tag?string

Only tasks with this tag.

q?string

Words in the title.

blocked?boolean

Only blocked tasks.

overdue?boolean

Only overdue tasks.

today?string

Your own day, for overdue. Left out, the organisation's.

Formatdate
archived?string

Open by default.

Default"open"
Value in"open""archived""trash""all"
field?string

A custom field to filter by.

field_value?string

The value that field has to have.

Response Body

A page of tasks.

application/json
  1. response
data*array<>
next_cursor*|

Pass this as cursor to get the next page. null on the last page.

Example"b3BhcXVlLWN1cnNvcg"
has_more*boolean
curl -X GET 'https://api.agoohq.com/v1/tasks?limit=25'
{  "data": [    {      "id": "string",      "ref_no": 0,      "title": "string",      "description": "string",      "acceptance": "string",      "kind": "task",      "parent_id": "string",      "container": {},      "owner": {},      "priority": "urgent",      "status": {},      "start_on": "2019-08-24",      "due_on": "2019-08-24",      "due_at": "2019-08-24T14:15:22Z",      "due_tz": "string",      "tags": [        "string"      ],      "source": {},      "completion_outcome": "done",      "series_id": "string",      "occurrence_key": "string",      "version": 0,      "created_at": "2019-08-24T14:15:22Z",      "updated_at": "2019-08-24T14:15:22Z"    }  ],  "next_cursor": "b3BhcXVlLWN1cnNvcg",  "has_more": true}