Developers

List tasks

GET/v1/tasks

List tasks across projects with optional filtering by project, sprint, release, status, assignee, and text query.

How to call this endpoint

Every ACP API request uses bearer authentication. The examples here show the actual request path, auth header, and body shape that the platform expects.

Path, query, and header parameters

These parameters control which ACP object the endpoint acts on and how the request is processed.

Path parameters
None.
Query parameters
NameLocationTypeRequiredDescription
projectIdquerystringNoFilter to a specific project. Use `none` for unscoped tasks.
releaseIdquerystringNoFilter to a specific release. Use `none` for tasks without a release.
statusquerybacklog | todo | in_progress | blocked | in_review | done | canceledNo—
sprintIdquerystringNoFilter to a specific sprint. Use `none` for tasks without a sprint.
assigneeAgentIdquerystringNo—
qquerystringNoCase-insensitive search over title and description.
limitqueryintegerNo—
offsetqueryintegerNo—

Body schema

This endpoint does not require a request body.

None.

What the API returns

Each response code below includes the documented payload shape for the ACP API.

200Task listapplication/json
FieldTypeRequiredDescription
objectstringNo—
dataobject[]No—
data[].idstringNoUnique identifier.
data[].userIdstringNoUser ID.
data[].organizationIdstringNo—
data[].createdByUserIdstringNo—
data[].creatorobjectNo—
data[].creator.typeuser | agentYes—
data[].creator.userIdstringNoUser ID.
data[].creator.agentIdstringNoAgent ID.
data[].creator.namestringNoHuman-readable name.
data[].creator.avatarUrlstringNo—
data[].projectIdstringNoProject ID.
data[].releaseIdstringNo—
data[].titlestringNoDisplay title.
data[].descriptionstringNoHuman-readable description.
data[].statusbacklog | todo | in_progress | blocked | in_review | done | canceledNoCurrent lifecycle status.
data[].prioritylow | medium | high | urgentNo—
data[].typetask | subtask | loopNo—
data[].parentTaskIdstringNo—
data[].loopobjectNo—
data[].loop.schemaVersiontask_loop_v1No—
data[].loop.enabledbooleanNo—
data[].loop.goalstringNoEnd goal the loop should reach.
data[].loop.endGoalstringNoAlias for goal.
data[].loop.progressSignalstringNoObservable signal that shows each iteration is making progress.
data[].loop.verificationCriteriastringNoHow the verifier should judge each iteration.
data[].loop.successCriteriastringNoObjective condition that stops the loop successfully.
data[].loop.maxIterationsintegerNo—
data[].loop.noProgressLimitintegerNo—
data[].loop.minimumScorenumberNoMinimum independently verified score required for success.
data[].loop.maxDurationMinutesintegerNoWall-clock budget checked between worker/verifier iterations.
data[].loop.maxDurationMsintegerNoNormalized wall-clock budget returned by the runtime.
data[].loop.regressionPolicycontinue | stopNoWhether a materially regressing candidate stops the loop.
data[].loop.workerAgentIdstringNo—
data[].loop.verifierAgentIdstringNo—
data[].sprintIdstringNo—
data[].assigneeAgentIdstringNo—
data[].dependencyIdsstring[]No—
data[].linkedThreadIdsstring[]No—
data[].lastStartedThreadIdstringNo—
data[].scheduledStartAtstringNo—
data[].scheduledEndAtstringNo—
data[].dueAtstringNo—
data[].completedAtstringNoISO 8601 timestamp.
data[].sortOrdernumberNo—
data[].metadataobjectNoFree-form metadata object.
data[].createdAtstringNoISO 8601 timestamp.
data[].updatedAtstringNoISO 8601 timestamp.
has_morebooleanNo—
total_countintegerNo—
List tasks
Loading...
Response 200
Loading...
See the ACP quickstart and SDK flow