> ## Documentation Index
> Fetch the complete documentation index at: https://docs.runaether.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# List a task's activity

> Lists one page of a task's activity feed, newest first: its primary pull request's feed with its own events when it has one, its own events otherwise.

Use this tool when you need to:
- Follow what happened on a task: its events and, once it has a pull request, the review runs, feedback dispatches, GitHub review verdicts and the merge
- Page back through a task's history

Examples:
- GET /tasks/{taskID}/activity
- GET /tasks/6f1c2a9e-3b7d-4c55-9a2e-0d8b1f4e7c21/activity?limit=100

Hints:
- taskID is the task's uuid. limit is optional, 1 to 200, default 50. cursor is optional: send the previous page's next_cursor; next_cursor is null on the last page, and a malformed cursor is 422.
- A task with a primary pull request (its published PR, or the PR a review task reviews) reads that pull request's feed: the authoring task's events, review run boundaries, delivered feedback dispatches, stored GitHub review verdicts and the merge. A review task reads its own events there too, its outcomes as its review run's boundaries. A task with none reads only its own events. The page names no pull request: the task's primary_pull_request does (getTask).
- Each item has a kind: task_event, review_run_completed, review_run_failed, dispatched, github_review or merged.
- Use listPullRequestActivity instead when you hold the pull request's id rather than a task's.
- Use listTaskTurns instead to read the task's transcript, and listTaskSubagents for the sub-agents, tool runs and commands its agent started.
- Owners, admins, members and viewers of the task's organization; a billing member is refused with 403 org_role_insufficient and a task the caller cannot see is 404. No GitHub connection is needed. 503 when the membership check is unavailable.



## OpenAPI

````yaml api-reference/openapi.json GET /tasks/{taskID}/activity
openapi: 3.1.0
info:
  title: Aether API
  version: 0.1.0
servers:
  - url: https://api.runaether.dev
security:
  - bearerAuth: []
paths:
  /tasks/{taskID}/activity:
    get:
      tags:
        - tasks
      summary: List a task's activity
      description: >-
        Lists one page of a task's activity feed, newest first: its primary pull
        request's feed with its own events when it has one, its own events
        otherwise.


        Use this tool when you need to:

        - Follow what happened on a task: its events and, once it has a pull
        request, the review runs, feedback dispatches, GitHub review verdicts
        and the merge

        - Page back through a task's history


        Examples:

        - GET /tasks/{taskID}/activity

        - GET /tasks/6f1c2a9e-3b7d-4c55-9a2e-0d8b1f4e7c21/activity?limit=100


        Hints:

        - taskID is the task's uuid. limit is optional, 1 to 200, default 50.
        cursor is optional: send the previous page's next_cursor; next_cursor is
        null on the last page, and a malformed cursor is 422.

        - A task with a primary pull request (its published PR, or the PR a
        review task reviews) reads that pull request's feed: the authoring
        task's events, review run boundaries, delivered feedback dispatches,
        stored GitHub review verdicts and the merge. A review task reads its own
        events there too, its outcomes as its review run's boundaries. A task
        with none reads only its own events. The page names no pull request: the
        task's primary_pull_request does (getTask).

        - Each item has a kind: task_event, review_run_completed,
        review_run_failed, dispatched, github_review or merged.

        - Use listPullRequestActivity instead when you hold the pull request's
        id rather than a task's.

        - Use listTaskTurns instead to read the task's transcript, and
        listTaskSubagents for the sub-agents, tool runs and commands its agent
        started.

        - Owners, admins, members and viewers of the task's organization; a
        billing member is refused with 403 org_role_insufficient and a task the
        caller cannot see is 404. No GitHub connection is needed. 503 when the
        membership check is unavailable.
      operationId: listTaskActivity
      parameters:
        - in: path
          name: taskID
          required: true
          schema:
            format: uuid
            pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
            type: string
        - explode: false
          in: query
          name: cursor
          schema:
            minLength: 1
            type: string
        - explode: false
          in: query
          name: limit
          schema:
            default: 50
            format: int64
            maximum: 200
            minimum: 1
            type: integer
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ActivityPage'
          description: OK
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TasksErrorResponse'
          description: Unauthorized
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OrgAuthorizationErrorResponse'
          description: Forbidden
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TasksErrorResponse'
          description: Not Found
        '410':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TasksErrorResponse'
          description: Gone
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TasksErrorResponse'
          description: Unprocessable Entity
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TasksErrorResponse'
          description: Internal Server Error
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TasksErrorResponse'
          description: Service Unavailable
components:
  schemas:
    ActivityPage:
      additionalProperties: false
      properties:
        items:
          items:
            $ref: '#/components/schemas/ActivityEvent'
          type: array
        next_cursor:
          minLength: 1
          type:
            - string
            - 'null'
      required:
        - items
        - next_cursor
      type: object
    TasksErrorResponse:
      additionalProperties: false
      properties:
        code:
          enum:
            - account_deleting
            - aether_inference_unserved
            - agent_pr_blocked
            - agent_pr_pending
            - agent_profile_changed
            - agent_starts_off
            - app_identity_missing
            - attribution_unavailable
            - bad_gateway
            - bad_request
            - caller_inactive
            - chat_archived
            - chat_settings_fixed
            - chats_not_addable
            - checkout_not_archivable
            - cli_upgrade_required
            - client_outdated
            - computer_bridge_outdated
            - computer_cli_outdated
            - computer_starts_no_agents
            - computer_starts_no_forks
            - computer_unreachable
            - conflict
            - connection_creator_only
            - connection_harness_mismatch
            - connection_not_held
            - contents_write_required
            - continuation_failed
            - continuation_unavailable
            - control_forbidden
            - creator_github_access_missing
            - credential_kind_not_admitted
            - download_unsupported
            - embeddings_unavailable
            - fix_not_requested
            - fix_requests_unrecorded
            - forbidden
            - fork_branch_delete_unsupported
            - fork_forbidden
            - gateway_timeout
            - github_claim_unverified
            - github_failed
            - github_identity_mismatch
            - github_identity_required
            - github_push_access_required
            - github_reconnect_required
            - github_ref_not_found
            - gone
            - handed_branch_protected
            - head_moved
            - html_render_nul_byte
            - html_render_too_large
            - idempotency_key_conflict
            - idempotency_key_reused
            - idle_compaction_not_pending
            - idle_compaction_skipped
            - inference_proxy_unavailable
            - insufficient_credits
            - insufficient_inference_balance
            - internal_error
            - invalid_request
            - last_queued_message
            - live_protocol_unsupported
            - main_chat_permanent
            - mcp_server_not_connected
            - merge_when_ready_requires_pr_review
            - message_not_queued
            - method_not_allowed
            - mode_forbidden
            - name_follows_session
            - no_checkout_on_computer
            - no_dispatch_target
            - no_turn_running
            - not_acceptable
            - not_found
            - not_implemented
            - onboarding_already_completed
            - onboarding_requirements_missing
            - org_id_required
            - org_role_insufficient
            - org_suspended
            - payment_required
            - pending_input_answered
            - permission_prompt_answered_in_terminal
            - permission_prompt_expired
            - permission_prompt_open
            - permission_prompt_stopped
            - pr_automation_unsupported
            - pr_review_actor_required
            - pr_review_connection_spent
            - pr_review_publish_forbidden
            - precondition_failed
            - project_archived
            - project_has_no_repository
            - project_repo_disconnected
            - project_repository_differs
            - project_required
            - pull_request_closed
            - pull_request_mirror_failed
            - pull_request_not_mirrored
            - push_file_too_large
            - push_rejected
            - push_secret_detected
            - question_answers
            - queued_stop_requires_discard
            - rate_limited
            - reasoning_effort_fixed
            - repository_administration_not_granted
            - repository_already_connected
            - repository_create_forbidden
            - repository_create_rejected
            - repository_created_not_linked
            - repository_owner_not_caller
            - request_canceled
            - request_timeout
            - request_too_large
            - review_name_follows_pull_request
            - sandbox_deleted
            - sandbox_failed
            - sandbox_needs_message
            - save_in_progress
            - save_requires_task_creator
            - service_unavailable
            - session_not_started_by_aether
            - slash_command
            - stack_cycle
            - stack_too_large
            - stack_two_parents
            - stale_execution
            - stale_or_indeterminate
            - stale_pending_input
            - stream_delivery_gap
            - stream_event_conflict
            - task_already_saved
            - task_archived
            - task_awaiting_message
            - task_awaiting_tool_response
            - task_backed_by_work_tree
            - task_bound_at_creation
            - task_branch_diverged
            - task_branch_is_default
            - task_branch_mismatch
            - task_branch_missing
            - task_connection_disconnected
            - task_creator_deleted
            - task_executing
            - task_file_too_large
            - task_fork_refused
            - task_has_no_commits
            - task_has_no_files
            - task_has_no_repository
            - task_history_has_merges
            - task_ineligible
            - task_is_child
            - task_not_accepting_messages
            - task_not_pinnable
            - task_not_started
            - task_rebase_in_progress
            - task_settings_changed
            - task_start_failed
            - task_start_pending
            - teleport_unavailable
            - terminal_chat
            - terminal_chat_continuation_refused
            - terminal_chat_run_running
            - terminal_question
            - too_many_live_connections
            - unauthenticated
            - unsigned_aether_head
            - unsigned_commit
            - unsupported_changes
            - unsupported_media_type
            - untyped_error
            - user_suspended
            - validation_failed
            - working_tree_dirty
            - workspace_git_unavailable
            - workspace_gone
            - workspace_outdated
            - workspace_rejected
          minLength: 1
          type: string
        error:
          minLength: 1
          type: string
        errors:
          items:
            $ref: '#/components/schemas/ErrorDetail'
          type: array
      required:
        - error
        - code
      type: object
    OrgAuthorizationErrorResponse:
      additionalProperties: false
      properties:
        code:
          enum:
            - org_membership_required
            - org_role_insufficient
            - org_suspended
            - account_deleting
            - agent_host_route_not_allowed
            - credential_kind_not_admitted
            - grant_scope_insufficient
          type: string
        error:
          minLength: 1
          type: string
      required:
        - error
        - code
      type: object
    ActivityEvent:
      discriminator:
        mapping:
          dispatched: '#/components/schemas/ActivityDispatchedEvent'
          github_review: '#/components/schemas/ActivityGitHubReviewEvent'
          merged: '#/components/schemas/ActivityMergedEvent'
          review_run_completed: '#/components/schemas/ActivityReviewRunCompletedEvent'
          review_run_failed: '#/components/schemas/ActivityReviewRunFailedEvent'
          task_event: '#/components/schemas/ActivityTaskEvent'
        propertyName: kind
      oneOf:
        - $ref: '#/components/schemas/ActivityTaskEvent'
        - $ref: '#/components/schemas/ActivityReviewRunCompletedEvent'
        - $ref: '#/components/schemas/ActivityReviewRunFailedEvent'
        - $ref: '#/components/schemas/ActivityDispatchedEvent'
        - $ref: '#/components/schemas/ActivityGitHubReviewEvent'
        - $ref: '#/components/schemas/ActivityMergedEvent'
    ErrorDetail:
      additionalProperties: false
      properties:
        location:
          description: >-
            Where the error occurred, e.g. 'body.items[3].tags' or
            'path.thing-id'
          type: string
        message:
          description: Error message text
          type: string
        value:
          description: The value at the given location
      type: object
    ActivityDispatchedEvent:
      additionalProperties: false
      properties:
        at:
          format: date-time
          type: string
        dispatch:
          discriminator:
            mapping:
              ci_head: '#/components/schemas/TaskGitHubDispatchCiHead'
              issue_comment: '#/components/schemas/TaskGitHubDispatchIssueComment'
              review: '#/components/schemas/TaskGitHubDispatchReview'
              review_comment: '#/components/schemas/TaskGitHubDispatchReviewComment'
            propertyName: kind
          oneOf:
            - $ref: '#/components/schemas/TaskGitHubDispatchCiHead'
            - $ref: '#/components/schemas/TaskGitHubDispatchReview'
            - $ref: '#/components/schemas/TaskGitHubDispatchReviewComment'
            - $ref: '#/components/schemas/TaskGitHubDispatchIssueComment'
        key:
          minLength: 1
          type: string
        kind:
          enum:
            - dispatched
          type: string
        task_id:
          format: uuid
          type: string
      required:
        - kind
        - key
        - at
        - task_id
        - dispatch
      type: object
    ActivityGitHubReviewEvent:
      additionalProperties: false
      properties:
        at:
          format: date-time
          type: string
        author_is_bot:
          type: boolean
        author_login:
          minLength: 1
          type: string
        commit_id:
          pattern: ^[0-9a-f]{40}$
          type: string
        findings_count:
          format: int64
          minimum: 0
          type: integer
        github_review_id:
          format: int64
          maximum: 9007199254740991
          minimum: 1
          type: integer
        html_url:
          format: uri
          pattern: ^[hH][tT][tT][pP][sS]?://
          type: string
        key:
          minLength: 1
          type: string
        kind:
          enum:
            - github_review
          type: string
        run:
          $ref: '#/components/schemas/ReviewRunRef'
        state:
          enum:
            - APPROVED
            - CHANGES_REQUESTED
            - COMMENTED
            - DISMISSED
          type: string
        verdict:
          enum:
            - COMMENT
            - APPROVE
            - REQUEST_CHANGES
          type: string
      required:
        - kind
        - key
        - at
        - github_review_id
        - author_login
        - author_is_bot
        - state
        - html_url
      type: object
    ActivityMergedEvent:
      additionalProperties: false
      properties:
        at:
          format: date-time
          type: string
        key:
          minLength: 1
          type: string
        kind:
          enum:
            - merged
          type: string
        merged_when_ready:
          $ref: '#/components/schemas/ActivityMergedWhenReady'
      required:
        - kind
        - key
        - at
      type: object
    ActivityReviewRunCompletedEvent:
      additionalProperties: false
      properties:
        at:
          format: date-time
          type: string
        key:
          minLength: 1
          type: string
        kind:
          enum:
            - review_run_completed
          type: string
        run_number:
          format: int64
          minimum: 1
          type: integer
        task_id:
          format: uuid
          type: string
      required:
        - kind
        - key
        - at
        - task_id
        - run_number
      type: object
    ActivityReviewRunFailedEvent:
      additionalProperties: false
      properties:
        at:
          format: date-time
          type: string
        key:
          minLength: 1
          type: string
        kind:
          enum:
            - review_run_failed
          type: string
        message:
          minLength: 1
          pattern: \S
          type: string
        run_number:
          format: int64
          minimum: 1
          type: integer
        task_id:
          format: uuid
          type: string
      required:
        - kind
        - key
        - at
        - task_id
        - run_number
        - message
      type: object
    ActivityTaskEvent:
      additionalProperties: false
      properties:
        at:
          format: date-time
          type: string
        key:
          minLength: 1
          type: string
        kind:
          enum:
            - task_event
          type: string
        message:
          minLength: 1
          pattern: \S
          type: string
        task_id:
          format: uuid
          type: string
        type:
          enum:
            - done
            - error
            - question
            - stop
            - workspace_lifecycle
            - workspace_warning
            - ci_passed
            - ci_failed
          type: string
      required:
        - kind
        - key
        - at
        - task_id
        - type
        - message
      type: object
    TaskGitHubDispatchCiHead:
      additionalProperties: false
      properties:
        dispatched_at:
          format: date-time
          type: string
        head_sha:
          minLength: 1
          type: string
        id:
          format: uuid
          type: string
        kind:
          enum:
            - ci_head
          type: string
        message_id:
          format: uuid
          type: string
        source:
          enum:
            - auto
            - manual
          type: string
      required:
        - id
        - kind
        - head_sha
        - source
        - dispatched_at
      type: object
    TaskGitHubDispatchIssueComment:
      additionalProperties: false
      properties:
        dispatched_at:
          format: date-time
          type: string
        github_comment_id:
          format: int64
          maximum: 9007199254740991
          minimum: 1
          type: integer
        id:
          format: uuid
          type: string
        kind:
          enum:
            - issue_comment
          type: string
        message_id:
          format: uuid
          type: string
        source:
          enum:
            - auto
            - manual
          type: string
      required:
        - id
        - kind
        - github_comment_id
        - source
        - dispatched_at
      type: object
    TaskGitHubDispatchReview:
      additionalProperties: false
      properties:
        dispatched_at:
          format: date-time
          type: string
        github_review_id:
          format: int64
          maximum: 9007199254740991
          minimum: 1
          type: integer
        id:
          format: uuid
          type: string
        kind:
          enum:
            - review
          type: string
        message_id:
          format: uuid
          type: string
        source:
          enum:
            - auto
            - manual
          type: string
      required:
        - id
        - kind
        - github_review_id
        - source
        - dispatched_at
      type: object
    TaskGitHubDispatchReviewComment:
      additionalProperties: false
      properties:
        dispatched_at:
          format: date-time
          type: string
        github_comment_id:
          format: int64
          maximum: 9007199254740991
          minimum: 1
          type: integer
        id:
          format: uuid
          type: string
        kind:
          enum:
            - review_comment
          type: string
        message_id:
          format: uuid
          type: string
        source:
          enum:
            - auto
            - manual
          type: string
      required:
        - id
        - kind
        - github_comment_id
        - source
        - dispatched_at
      type: object
    ReviewRunRef:
      additionalProperties: false
      properties:
        run_number:
          format: int64
          minimum: 1
          type: integer
        task_id:
          format: uuid
          type: string
      required:
        - task_id
        - run_number
      type: object
    ActivityMergedWhenReady:
      additionalProperties: false
      description: >-
        Set when merge_when_ready recorded this merge as its outcome: the head
        merged and the merge commit GitHub made. It names no merger.
      properties:
        head_sha:
          minLength: 1
          type: string
        merge_sha:
          minLength: 1
          type: string
      required:
        - head_sha
        - merge_sha
      type: object
  securitySchemes:
    bearerAuth:
      bearerFormat: JWT
      scheme: bearer
      type: http

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.