List task activity

GET/v1/tasks/{taskId}/activity

List the chronological task audit trail, including creation, status and field changes, linked threads, and comments.

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

Name	Location	Type	Required	Description
taskId	path	string	Yes	Task ID

Query parameters

Name	Location	Type	Required	Description
limit	query	integer	No	—
offset	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.

200Task 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 \| completed \| failed \| cancelled	No	Current lifecycle status.
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.totalCost	number	No	—
data[].thread.environmentMinutes	number	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.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.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.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	—

List task activity

Response 200

See the ACP quickstart and SDK flow