---
title: "List items in the workspace"
method: GET
path: "/workspaces/{workspaceSlug}/practices/items"
tags: ["item"]
---

# List items in the workspace

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

## Request

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

## Path parameters

- `workspaceSlug` string, required

## Query parameters

- `itemKind` string
- `page` integer
- `size` integer

## Response `200`

OK

- PageResponseDTOItemRef: Stable wire representation for the APIs that expose flat page metadata. Spring Data's PageImpl is an implementation detail, not a JSON contract; these fields preserve the existing clients' response shape without relying on its bean properties. New APIs use Spring Data's PagedModel.
  - `content` 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
  - `empty` boolean, required
  - `first` boolean, required
  - `last` boolean, required
  - `number` integer, required
  - `numberOfElements` integer, required
  - `pageable` Pageable, required
    - `offset` integer, required
    - `pageNumber` integer, required
    - `pageSize` integer, required
    - `paged` boolean, required
    - `sort` Sort, required
      - `empty` boolean, required
      - `sorted` boolean, required
      - `unsorted` boolean, required
    - `unpaged` boolean, required
  - `size` integer, required
  - `sort` Sort, required
    - `empty` boolean, required
    - `sorted` boolean, required
    - `unsorted` boolean, required
  - `totalElements` integer, required
  - `totalPages` integer, required

## Changes

- **2026-10-17** `4b8a89bf492c`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/hephaestus-build/apis/hephaestus-api/changes/workspaces/:workspaceSlug/practices/items/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)