List tasks

List bugs, feature requests and project tasks, most recently updated first, with an exact total. Filters combine: for example, open high-priority bugs in one product.

GET/v1/w/{workspace}/tasks

Path parameters

workspacestringrequired

Your workspace’s address name.

Query parameters

milestonestring

A milestone id, or none; needs a single product.

sprintstring

A sprint id, current, next, or none.

viewstring

A saved task view’s id; its filters apply.

statusenum

open (the default), active (open, in progress or to test), a single status, or all.

typeenum

bug, feature, task or all.

productstring

One product or project key.

surfacestring

Only tasks seen on this surface, like web.

querystring

Words to find in the id, title, description, reporter or assignee.

parentstring

Only the sub-tasks of this task.

topLevelboolean

true to leave out sub-tasks.

dueenum

overdue, today, week (the next seven days), set (has a due date) or none.

todaystring

Today as YYYY-MM-DD in your time zone, for the due filter. Defaults to today in UTC.

limitinteger

How many to return, 1 to 200. Defaults to 50.

cursorstring

The nextCursor from the previous page; leave out for the first page.

Response

totalnumberrequired

nextCursorstring | nullrequired

itemsobject[]required

Details

List bugs, feature requests and project tasks. Filters combine with AND. Returns items newest-updated first (soonest due first when filtering by due date) with an exact total and a cursor for the next page.

Since 2026-12. Errors are listed in Errors.

cURL

curl -G "https://api.olamma.sh/v1/w/your-workspace/tasks" \
  -H "Authorization: Bearer $OLAMMA_KEY" \
  --data-urlencode 'status=active' \
  --data-urlencode 'type=bug' \
  --data-urlencode 'product=APP' \
  --data-urlencode 'limit=25'

Response 200

{
  "total": 123,
  "nextCursor": "<string>",
  "items": [
    {
      "id": "<string>",
      "product": "<string>",
      "type": "<string>",
      "title": "<string>",
      "status": "<string>",
      "priority": "<string>",
      "surface": "<string>",
      "reporter": "<string>",
      "assignee": "<string>",
      "parent": "<string>",
      "dueOn": "<string>",
      "updatedAt": "2026-12-01T09:30:00Z"
    }
  ]
}