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

# List Task Activity

> List the activity timeline for a task.

Combines status transitions, assignments, comments, agent start
events, and resource mutations into a single stream ordered newest
first. Mutation entries surface the operation and changed field
names; full before/after snapshots live on the ``/mutations``
endpoint.

Returns:
    Activity entries ordered newest first.

Raises:
    NotFoundError: If task not found.



## OpenAPI

````yaml https://api.pragmatiks.io/openapi.json get /agents/tasks/{task_id}/activity
openapi: 3.1.0
info:
  title: Pragma API
  version: 0.1.0
servers: []
security: []
paths:
  /agents/tasks/{task_id}/activity:
    get:
      tags:
        - tasks
      summary: List Task Activity
      description: |-
        List the activity timeline for a task.

        Combines status transitions, assignments, comments, agent start
        events, and resource mutations into a single stream ordered newest
        first. Mutation entries surface the operation and changed field
        names; full before/after snapshots live on the ``/mutations``
        endpoint.

        Returns:
            Activity entries ordered newest first.

        Raises:
            NotFoundError: If task not found.
      operationId: tasks-list_task_activity
      parameters:
        - name: task_id
          in: path
          required: true
          schema:
            type: string
            title: Task Id
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            maximum: 200
            minimum: 1
            description: Maximum entries to return
            default: 50
            title: Limit
          description: Maximum entries to return
        - name: cursor
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: >-
              Composite cursor '<iso-timestamp>|<edge-id>'; returns entries
              strictly older than this point under (timestamp DESC, edge_id
              DESC).
            title: Cursor
          description: >-
            Composite cursor '<iso-timestamp>|<edge-id>'; returns entries
            strictly older than this point under (timestamp DESC, edge_id DESC).
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/TaskActivityEntry'
                title: Response Tasks-List Task Activity
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    TaskActivityEntry:
      properties:
        kind:
          $ref: '#/components/schemas/TaskActivityKind'
        timestamp:
          type: string
          format: date-time
          title: Timestamp
        edge_id:
          type: string
          title: Edge Id
        from_status:
          anyOf:
            - type: string
            - type: 'null'
          title: From Status
        to_status:
          anyOf:
            - type: string
            - type: 'null'
          title: To Status
        assignee_table:
          anyOf:
            - type: string
            - type: 'null'
          title: Assignee Table
        assignee_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Assignee Id
        comment_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Comment Id
        instance_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Instance Id
        operation:
          anyOf:
            - type: string
            - type: 'null'
          title: Operation
        resource_table:
          anyOf:
            - type: string
            - type: 'null'
          title: Resource Table
        resource_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Resource Id
        fields_changed:
          anyOf:
            - items:
                type: string
              type: array
            - type: 'null'
          title: Fields Changed
      type: object
      required:
        - kind
        - timestamp
        - edge_id
      title: TaskActivityEntry
      description: |-
        A single entry in a task's derived activity timeline.

        Each entry corresponds to one graph edge: status transitions,
        assignments, comments, agent start events, or resource mutations.
        Mutation entries are emitted starting in PRA-327 phase 2.

        Attributes:
            kind: Discriminator for the entry shape.
            timestamp: When the underlying edge was created.
            edge_id: SurrealDB edge identifier (no table prefix).
            from_status: Source status for transition entries.
            to_status: Target status for transition entries.
            assignee_table: Table of the assignee for assignment entries.
            assignee_id: Identifier of the assignee for assignment entries.
            comment_id: Comment node id for comment entries.
            instance_id: Agent instance id for agent_started entries.
            operation: Mutation operation for mutation entries
                (``create`` / ``update`` / ``delete``).
            resource_table: SurrealDB table for the mutated resource
                (``resources`` in the current schema).
            resource_id: SurrealDB record id of the mutated resource
                (id part only).
            fields_changed: Top-level field names whose value differs
                between before and after on the mutation. Used for the
                activity-timeline summary; the full before/after lives on
                the mutation log endpoint.
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    TaskActivityKind:
      type: string
      enum:
        - transition
        - assignment
        - mutation
        - comment
        - agent_started
      title: TaskActivityKind
      description: Discriminator for entries in the activity timeline.
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError

````