List project task activity

GET/v1/tasks/activity

List the latest non-comment ticket actions for a project, ordered newest first.

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

Name	Location	Type	Required	Description
projectId	query	string	Yes	Project whose ticket activity should be returned.
limit	query	integer	No	—

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.

200Project task activity listapplication/json

Field	Type	Required	Description
object	string	No	—
data	object[]	No	—
data[].object	string	No	—
data[].id	string	No	Unique identifier.
data[].userId	string	No	User ID.
data[].organizationId	string	No	—
data[].createdByUserId	string	No	—
data[].taskId	string	No	—
data[].projectId	string	No	Project ID.
data[].eventType	created \| status_changed \| field_changed \| thread_started \| comment_added	No	—
data[].sourceId	string	No	—
data[].actorType	user \| agent \| system	No	—
data[].actorUserId	string	No	—
data[].actorAgentId	string	No	—
data[].actorName	string	No	—
data[].actorAvatarUrl	string	No	—
data[].fieldName	string	No	—
data[].previousValue	string	No	—
data[].nextValue	string	No	—
data[].threadId	string	No	Thread ID.
data[].commentId	string	No	—
data[].thread	object	No	—
data[].thread.id	string	No	Unique identifier.
data[].thread.userId	string	No	User ID.
data[].thread.organizationId	string	No	—
data[].thread.createdByUserId	string	No	—
data[].thread.projectId	string	No	Project ID.
data[].thread.environmentId	string	No	Computer ID.
data[].thread.agentId	string	No	Agent ID.
data[].thread.title	string	No	Display title.
data[].thread.task	string	No	—
data[].thread.appId	string	No	—
data[].thread.status	active \| running \| permission_asked \| completed \| failed \| archived \| cancelled \| deleted	No	Current lifecycle status.
data[].thread.contextId	string	No	—
data[].thread.contextName	string	No	—
data[].thread.messageCount	integer	No	—
data[].thread.lastMessageAt	string	No	—
data[].thread.lastMessagePreview	string	No	—
data[].thread.inputTokens	integer	No	—
data[].thread.outputTokens	integer	No	—
data[].thread.cacheTokens	integer	No	—
data[].thread.totalTokens	integer	No	—
data[].thread.agentCost	number	No	—
data[].thread.agentCostUsd	number	No	—
data[].thread.environmentCost	number	No	—
data[].thread.environmentCostUsd	number	No	—
data[].thread.totalCost	number	No	—
data[].thread.totalCostUsd	number	No	—
data[].thread.agentCT	integer	No	—
data[].thread.environmentCT	integer	No	—
data[].thread.totalCT	integer	No	—
data[].thread.environmentMinutes	number	No	—
data[].thread.environmentStorageGB	number	No	—
data[].thread.attachments	object[]	No	—
data[].thread.metadata	object	No	Free-form metadata object.
data[].thread.teamExecution	object	No	—
data[].thread.teamExecution.mode	team	No	—
data[].thread.teamExecution.teamAgentId	string	No	—
data[].thread.teamExecution.teamAgentName	string	No	—
data[].thread.teamExecution.orchestrator	object	No	—
data[].thread.teamExecution.orchestrator.agentId	string	No	Agent ID.
data[].thread.teamExecution.orchestrator.agentName	string	No	—
data[].thread.teamExecution.orchestrator.claudeAgentName	string	No	—
data[].thread.teamExecution.subagents	object[]	No	—
data[].thread.teamExecution.subagents[].agentId	string	No	Agent ID.
data[].thread.teamExecution.subagents[].agentName	string	No	—
data[].thread.teamExecution.subagents[].claudeAgentName	string	No	—
data[].thread.subagentActivity	object[]	No	—
data[].thread.subagentActivity[].agentId	string	No	Agent ID.
data[].thread.subagentActivity[].agentName	string	No	—
data[].thread.subagentActivity[].claudeAgentName	string	No	—
data[].thread.subagentActivity[].eventCount	integer	No	—
data[].thread.subagentActivity[].lastActiveAt	string	No	—
data[].thread.subagentActivity[].teamAgentId	string	No	—
data[].thread.subagentActivity[].teamAgentName	string	No	—
data[].thread.environmentName	string	No	—
data[].thread.agentName	string	No	—
data[].thread.agentPhotoUrl	string	No	—
data[].thread.agentAvatarUrl	string	No	—
data[].thread.startedAt	string	No	ISO 8601 timestamp.
data[].thread.completedAt	string	No	ISO 8601 timestamp.
data[].thread.duration	string	No	—
data[].thread.queuedInBatch	boolean	No	—
data[].thread.batchJobId	string	No	—
data[].thread.admissionReason	string	No	—
data[].thread.createdAt	string	No	ISO 8601 timestamp.
data[].thread.updatedAt	string	No	ISO 8601 timestamp.
data[].comment	object	No	—
data[].comment.object	string	No	—
data[].comment.id	string	No	Unique identifier.
data[].comment.userId	string	No	User ID.
data[].comment.organizationId	string	No	—
data[].comment.createdByUserId	string	No	—
data[].comment.projectId	string	No	Project ID.
data[].comment.taskId	string	No	—
data[].comment.task	object	No	—
data[].comment.task.object	string	No	—
data[].comment.task.id	string	No	Unique identifier.
data[].comment.task.projectId	string	No	Project ID.
data[].comment.task.releaseId	string	No	—
data[].comment.task.title	string	No	Display title.
data[].comment.task.status	backlog \| todo \| in_progress \| blocked \| in_review \| done \| canceled	No	Current lifecycle status.
data[].comment.task.priority	low \| medium \| high \| urgent	No	—
data[].comment.task.sprintId	string	No	—
data[].comment.task.assigneeAgentId	string	No	—
data[].comment.body	string	No	—
data[].comment.authorType	user \| agent \| system	No	—
data[].comment.authorAgentId	string	No	—
data[].comment.authorUserId	string	No	—
data[].comment.authorName	string	No	—
data[].comment.authorAvatarUrl	string	No	—
data[].comment.sourceThreadId	string	No	—
data[].comment.threadId	string	No	Thread ID.
data[].comment.parentCommentId	string	No	—
data[].comment.metadata	object	No	Free-form metadata object.
data[].comment.createdAt	string	No	ISO 8601 timestamp.
data[].comment.updatedAt	string	No	ISO 8601 timestamp.
data[].task	object	No	—
data[].task.id	string	No	Unique identifier.
data[].task.userId	string	No	User ID.
data[].task.organizationId	string	No	—
data[].task.createdByUserId	string	No	—
data[].task.creator	object	No	—
data[].task.creator.type	user \| agent	Yes	—
data[].task.creator.userId	string	No	User ID.
data[].task.creator.agentId	string	No	Agent ID.
data[].task.creator.name	string	No	Human-readable name.
data[].task.creator.avatarUrl	string	No	—
data[].task.projectId	string	No	Project ID.
data[].task.releaseId	string	No	—
data[].task.title	string	No	Display title.
data[].task.description	string	No	Human-readable description.
data[].task.status	backlog \| todo \| in_progress \| blocked \| in_review \| done \| canceled	No	Current lifecycle status.
data[].task.priority	low \| medium \| high \| urgent	No	—
data[].task.type	task \| subtask \| loop	No	—
data[].task.parentTaskId	string	No	—
data[].task.loop	object	No	—
data[].task.loop.schemaVersion	task_loop_v1	No	—
data[].task.loop.enabled	boolean	No	—
data[].task.loop.goal	string	No	End goal the loop should reach.
data[].task.loop.endGoal	string	No	Alias for goal.
data[].task.loop.progressSignal	string	No	Observable signal that shows each iteration is making progress.
data[].task.loop.verificationCriteria	string	No	How the verifier should judge each iteration.
data[].task.loop.successCriteria	string	No	Objective condition that stops the loop successfully.
data[].task.loop.maxIterations	integer	No	—
data[].task.loop.noProgressLimit	integer	No	—
data[].task.loop.minimumScore	number	No	Minimum independently verified score required for success.
data[].task.loop.maxDurationMinutes	integer	No	Wall-clock budget checked between worker/verifier iterations.
data[].task.loop.maxDurationMs	integer	No	Normalized wall-clock budget returned by the runtime.
data[].task.loop.regressionPolicy	continue \| stop	No	Whether a materially regressing candidate stops the loop.
data[].task.loop.workerAgentId	string	No	—
data[].task.loop.verifierAgentId	string	No	—
data[].task.sprintId	string	No	—
data[].task.assigneeAgentId	string	No	—
data[].task.dependencyIds	string[]	No	—
data[].task.linkedThreadIds	string[]	No	—
data[].task.lastStartedThreadId	string	No	—
data[].task.scheduledStartAt	string	No	—
data[].task.scheduledEndAt	string	No	—
data[].task.dueAt	string	No	—
data[].task.completedAt	string	No	ISO 8601 timestamp.
data[].task.sortOrder	number	No	—
data[].task.metadata	object	No	Free-form metadata object.
data[].task.createdAt	string	No	ISO 8601 timestamp.
data[].task.updatedAt	string	No	ISO 8601 timestamp.
data[].metadata	object	No	Free-form metadata object.
data[].createdAt	string	No	ISO 8601 timestamp.
has_more	boolean	No	—
total_count	integer	No	—

400Invalid requestapplication/json

Field	Type	Required	Description
error	string	Yes	—
message	string	No	Message text.
code	string	No	—

404Resource not foundapplication/json

Field	Type	Required	Description
error	string	No	—

List project task activity

Response 200

See the ACP quickstart and SDK flow