Skip to main content

Endpoint

Authentication

This endpoint requires an OAuth access token. Send it as a bearer token:
Required scope: tasks:read

Path Parameters

Query Parameters

Request Example

Response

Success Response

Status Code: 200 OK

Response Fields

Activity Log Entry Fields

Error Responses

400 Bad Request

Returned when the access token has no user behind it. client_credentials tokens act as the admin who created the application, so this applies only to tokens issued before application creators were recorded.

401 Unauthorized

Returned when the access token is missing, unknown, revoked, or expired, or when an X-API-Key was sent instead of a bearer token. See OAuth error responses.

403 Forbidden

Returned when the token lacks the required scope:
Or when the user may not access this task:

404 Not Found

Returned when the task does not exist.

422 Validation Error

Returned when query parameters are invalid (e.g., limit outside the 1–200 range).

429 Too Many Requests

Returned when your organization exceeds its per-minute request limit.

500 Internal Server Error

Returned when the request fails due to a server error.

Notes

Use the activity_log_id from these results as the reply_to value when adding a comment to create threaded conversations.
Set only_user_comments to true to filter out system-generated entries and see only comments posted by users.
Use limit and offset together to paginate through large activity histories. The total_count field tells you how many entries exist in total.

Use Cases

This endpoint is useful for:
  • Audit trails - Review the full history of actions taken on a task
  • Comment syncing - Pull task comments into external systems like Slack or a CRM
  • Threaded replies - Fetch existing comments to display conversation threads and reply to specific entries
  • Activity dashboards - Build custom views showing task progress and team interactions