Skip to content
LogoLogo

List bounded Workspace Tasks

List bounded Workspace Tasks

GET/api/v1/workspaces/{workspace_id}/tasks

Returns a newest-updated-first cursor page of Tasks in the current Workspace. It is an activity collection, not a text-search endpoint. Repeated project_id and status_category filters use OR semantics; a Project outside the Workspace simply contributes no rows. With consistency=checked, Core binds continuation to the normalized filters, caller, collection version and visibility revision. Complete coverage requires an unchanged scan ending without a cursor. Changed data or permissions returns an empty stale page without continuation. Ten pages or 1,000 rows caps a scan; an incomplete capped result remains partial. Restart stale scans explicitly. Omitted consistency preserves legacy pagination without a completeness claim.

Path Parameters

workspace_idRequired
string <uuid>
Example0198ac5e-f9b7-7000-8000-000000000001

Query Parameters

cursor
string·min 1·max 2048

Opaque continuation cursor returned by the preceding page.

limit
integer·min 1·max 100·default 50

Maximum number of resources to return.

project_id
string <uuid>[]·max 100

Restrict to one or more Project identifiers.

status_category
string[]·max 5

Restrict to one or more Status lifecycle categories.

Values
backlogtodoin_progressin_reviewdone
behavior
string[]·max 8

Keep Tasks whose current stage has every named lifecycle behavior enabled (AND semantics, at most 8 distinct keys). Keys are the Task-applicable entries of listLifecycleBehaviors; an unknown or non-Task key is a 400. Totals and cursors honor the filter.

Values
notifyshow_activetreat_as_closedcounts_as_completedallow_changes
assignee_actor_id
string <uuid>
Example0198ac5e-f9b7-7000-8000-000000000001
milestone_id
string <uuid>
Example0198ac5e-f9b7-7000-8000-000000000001
updated_since
string <date-time>

Include Tasks updated at or after this instant.

Example2026-08-15T12:00:00Z
include_archived
boolean·default false

Include archived Tasks; omitted or false returns active Tasks only.

consistency
string

Opt into service-derived coverage and version-bound pagination.

Values
checked
state
string·default all

Active means unresolved; omitted or all includes active and resolved Tasks.

Values
activeresolvedall
resolution
string

Restrict to completed or cancelled resolution. Incompatible with active state.

Values
completedcancelled

Responses