---
title: "List Harbor Contexts"
method: GET
path: "/api/harbors/{harbor_id}/contexts"
tags: ["Harbors"]
---

# List Harbor Contexts

`GET /api/harbors/{harbor_id}/contexts`

Lists context document metadata for a Harbor without returning document content.

Collection items include the current published `version` number and omit
`content`. Use the context item endpoint to retrieve a complete document.

A Harbor profile credential can read context only when `harbor_id` identifies
its own Harbor.

## Path parameters

- `harbor_id` string, uuid, required — Unique identifier of the Harbor.

## Query parameters

- `limit` integer — Maximum number of context documents to return. Defaults to 50 and cannot exceed 50.
- `page_token` string — Opaque pagination cursor returned by the previous request.

## Headers

- `X-Polytomic-Version` string

## Response `200`

OK

- HarborContextListEnvelope
  - `data` HarborContextMetadataResponse[], nullable
    - `created_at` string, date-time — When the context document was created.
    - `description` string — Short summary of the context document.
    - `id` string, uuid — Unique identifier of the context document.
    - `title` string — Human-readable context title.
    - `updated_at` string, date-time — When the context document was last updated.
    - `version` integer — Current published version number of the context document.
  - `pagination` PaginationDetails
    - `next_page_token` string

## Other responses

- `403` — Forbidden
- `404` — Not Found
- `422` — Unprocessable Entity
- `500` — Internal Server Error

## Changes

- **2026-08-26** `8d7294388f3f` — 1 info
  - added the optional property `data/items/version` to the response with the `200` status
- **2026-08-14** `42f4cfea0ea3` — 1 breaking, 2 warning
  - for the `query` request parameter `limit`, default value `50` was added
  - for the `query` request parameter `limit`, the max was set to `50.00`
  - for the `query` request parameter `limit`, the min was set to `1.00`
- **2026-08-13** `00c653316d35` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/polytomic/apis/polytomic-api/changes/api/harbors/:harbor_id/contexts/get.md)

---

[API](https://skmtc.dev/polytomic/apis/polytomic-api.md) · [All operations](https://skmtc.dev/polytomic/apis/polytomic-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/polytomic/polytomic-api/revisions/d40615e3d6f8/schema)