---
title: "List an issue's history"
method: GET
path: "/issues/{issueId}/history"
tags: ["Issues"]
---

# List an issue's history

`GET /issues/{issueId}/history`

## Request

- Base URL: `https://api.sazabi.com/v1`
- URL: `https://api.sazabi.com/v1/issues/{issueId}/history`
- Auth: none declared

List an issue's activity oldest first, as the issue page shows it: who did what and when, with the note and the document each entry carries. The `created` entry carries the issue's report.

## Path parameters

- `issueId` string, uuid, required: Issue to list the history of.

## Response `200`

OK

- object
  - `events` object[], required: Oldest first.
    - `id` string, uuid, required
    - `eventType` 'created' | 'fix_requested' | 'ignored' | 'rejected' | 'resolved' | 'muted' | 'unmuted' | 'updated', required: What happened.
    - `actorType` 'agent' | 'user' | 'system', required: Who did it: Sazabi's agent, a person, or Sazabi itself.
    - `actorName` string, nullable, required: The person's name. Null when the actor is not a person or is hidden from the caller.
    - `note` string, nullable, required: A short note on the entry, such as the reason for a change.
    - `metadata` object, nullable, required: Details of the entry, such as the severity levels of a severity change.
    - `mdxSource` string, nullable, required: The entry's document as MDX source, when it carries one: the report on the `created` entry, an update on an `updated` entry.
    - `mdxDocument` object, nullable, required: The same document compiled to Sazabi's MDX render tree, for rendering without an MDX compiler. Null when there is no document or it failed to compile.
      - `version` unknown, required
      - `root` object, required
        - `type` 'root', required
        - `children` union[], required
          - union
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
      - `componentNames` string[], required
      - `limits` object, required
        - `maxSourceLength` integer, required
        - `maxNodeCount` integer, required
        - `maxComponentCount` integer, required
        - `maxTableRows` integer, required
        - `maxChartPoints` integer, required
        - `maxPropPayloadSize` integer, required
        - `maxComponentDepth` integer, required
        - `maxCodeBlockLength` integer, required
        - `maxTextLength` integer, required
    - `createdAt` string, date-time, required

## Changes

- **2026-10-11** `5f4a1feb193a`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/sazabi/apis/sazabi-public-api/changes/issues/:issueId/history/get.md)

---

[API](https://skmtc.dev/sazabi/apis/sazabi-public-api.md) - [All operations](https://skmtc.dev/sazabi/apis/sazabi-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sazabi/apis/sazabi-public-api/revisions/965b6230cf45?raw)
