---
title: "Trace reviews of an item"
method: GET
path: "/workspaces/{workspaceSlug}/practices/items/{itemId}/trace"
tags: ["item-trace"]
---

# Trace reviews of an item

`GET /workspaces/{workspaceSlug}/practices/items/{itemId}/trace`

## Request

- Base URL: `/` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/workspaces/{workspaceSlug}/practices/items/{itemId}/trace`
- Auth: HTTP bearer

## Path parameters

- `workspaceSlug` string, required
- `itemId` string, required

## Response `200`

OK

- ItemTrace
  - `events` ItemEvent[], required
    - `decidedAt` string, date-time, nullable, required
    - `foundBy` 'WEBHOOK' | 'SYNC' | 'REQUEST' | 'BACKFILL' | 'SCHEDULE', required
    - `id` string, uuid, required
    - `itemId` string, required
    - `itemVersion` string, nullable, required
    - `name` string, required
    - `occurredAt` string, date-time, required
    - `reason` 'GATE_WITHHELD' | 'COOLDOWN_ACTIVE' | 'REQUEST_COOLDOWN_ACTIVE' | 'REQUESTER_QUOTA_EXHAUSTED' | 'CONCURRENT_DUPLICATE' | 'COALESCED' | 'OUT_OF_REVIEW_SCOPE' | 'BOT_AUTHOR' | 'BOT_REVIEWER' | 'STALE_ROLLOUT_REVISION' | 'WORKSPACE_INACTIVE' | 'PRACTICES_DISABLED' | 'NO_ACTIVE_PRACTICE' | 'REVIEW_MODEL_UNBOUND' | 'MEMBER_AI_DECLINED' | 'PERSON_DATA_ERASED' | 'FEEDBACK_MODE_OFF' | 'SUBJECT_UNLINKED' | 'MERGE_ACTOR_UNAVAILABLE' | 'MODEL_UNAVAILABLE' | 'BUDGET_EXHAUSTED' | 'ITEM_NOT_VISIBLE' | 'VERSION_SUPERSEDED' | 'PENDING_DEADLINE_EXCEEDED' | 'ITEM_GONE' | 'LEGACY_REVIEW_UNBOUND' | 'OCCASION_EVIDENCE_UNAVAILABLE' | 'null', nullable, required
    - `reviewId` string, uuid, nullable, required
    - `state` 'RECORDED' | 'WAITING' | 'STARTED' | 'WITHHELD' | 'EXPIRED', required
  - `item` ItemRef, required
    - `container` string, nullable, required
    - `id` string, required
    - `kind` string, required
    - `label` string, required
    - `parentId` string, nullable, required
    - `path` string, nullable, required
    - `provider` 'GITHUB' | 'GITLAB' | 'SLACK' | 'OUTLINE' | 'null', nullable, required
    - `removedAt` string, date-time, nullable, required
    - `title` string, nullable, required
    - `url` string, nullable, required
  - `practices` PracticeTraceEntry[], required
    - `about` 'AUTHOR' | 'REVIEWER' | 'ASSIGNEE' | 'MERGER' | 'null', nullable, required
    - `feedbackMode` 'OFF' | 'APPROVE_FIRST' | 'AUTOMATIC', required
    - `practiceSlug` string, required
    - `results` ReviewResultCounts, required
      - `couldNotDetermine` integer, required
      - `doesNotApply` integer, required
      - `met` integer, required
      - `notMet` integer, required
    - `review` ReviewRef, required
      - `completedAt` string, date-time, nullable, required
      - `createdAt` string, date-time, required
      - `id` string, uuid, required
      - `item` ItemRef, required
        - `container` string, nullable, required
        - `id` string, required
        - `kind` string, required
        - `label` string, required
        - `parentId` string, nullable, required
        - `path` string, nullable, required
        - `provider` 'GITHUB' | 'GITLAB' | 'SLACK' | 'OUTLINE' | 'null', nullable, required
        - `removedAt` string, date-time, nullable, required
        - `title` string, nullable, required
        - `url` string, nullable, required
      - `itemVersion` string, nullable, required
      - `kind` 'ITEM' | 'SCAN', required
      - `origin` 'EVENT' | 'REQUEST' | 'SCHEDULE' | 'BACKFILL', required
      - `status` 'QUEUED' | 'RUNNING' | 'COMPLETE' | 'PARTIAL' | 'FAILED' | 'CANCELLED', required
    - `reviewOn` ReviewOn, required
      - `events` string[], required
      - `state` object, required
    - `withheldReasons` ReasonCount[], required
      - `count` integer, required
      - `description` string, required
      - `reason` string, required
  - `reviews` ReviewRef[], required
    - `completedAt` string, date-time, nullable, required
    - `createdAt` string, date-time, required
    - `id` string, uuid, required
    - `item` ItemRef, required
      - `container` string, nullable, required
      - `id` string, required
      - `kind` string, required
      - `label` string, required
      - `parentId` string, nullable, required
      - `path` string, nullable, required
      - `provider` 'GITHUB' | 'GITLAB' | 'SLACK' | 'OUTLINE' | 'null', nullable, required
      - `removedAt` string, date-time, nullable, required
      - `title` string, nullable, required
      - `url` string, nullable, required
    - `itemVersion` string, nullable, required
    - `kind` 'ITEM' | 'SCAN', required
    - `origin` 'EVENT' | 'REQUEST' | 'SCHEDULE' | 'BACKFILL', required
    - `status` 'QUEUED' | 'RUNNING' | 'COMPLETE' | 'PARTIAL' | 'FAILED' | 'CANCELLED', required

## Changes

- **2026-10-22** `3592ab716973`: 1 warning
  - added the new `OCCASION_EVIDENCE_UNAVAILABLE` enum value to the `events/items/reason` response property for the response status `200`
- **2026-10-17** `4b8a89bf492c`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/hephaestus-build/apis/hephaestus-api/changes/workspaces/:workspaceSlug/practices/items/:itemId/trace/get.md)

---

[API](https://skmtc.dev/hephaestus-build/apis/hephaestus-api.md) · [All operations](https://skmtc.dev/hephaestus-build/apis/hephaestus-api/llms.txt) · [OpenAPI document](https://skmtc.dev/hephaestus-build/apis/hephaestus-api/revisions/3592ab716973?raw)