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

# List Harbor Context Drafts

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

Lists mutable Harbor context drafts without returning document content.

The collection includes drafts for published context documents and initial drafts
that have not yet been published. Use `context_id` with the draft detail,
replacement, promotion, and discard endpoints.

Draft metadata does not include `content`. Fetch a selected draft through its
detail endpoint to read the complete candidate. Normal context list and detail
operations continue to return published content only.

## Path parameters

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

## Query parameters

- `limit` integer — Maximum number of mutable drafts 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

- HarborContextDraftListEnvelope
  - `data` HarborContextDraftMetadataResponse[], nullable
    - `base_revision_id` string, uuid, nullable — Published revision on which this draft is based. Null for an unpublished context's initial draft.
    - `change_note` string, nullable — Optional note copied to the published version on promotion.
    - `context_id` string, uuid — Stable context document identity. Use this ID for draft replacement, promotion, and discard.
    - `created_at` string, date-time — When the draft was created.
    - `created_by` string, uuid, nullable — Actor that created the draft. Null for the system actor.
    - `created_by_type` string — Type of actor that created the draft.
    - `description` string — Draft description.
    - `id` string, uuid — Unique identifier of the mutable draft.
    - `title` string — Draft title.
    - `updated_at` string, date-time — When the draft was most recently replaced.
    - `updated_by` string, uuid, nullable — Actor that most recently replaced the draft. Null for the system actor.
    - `updated_by_type` string — Type of actor that most recently replaced the draft.
  - `pagination` PaginationDetails
    - `next_page_token` string

## Other responses

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

---

[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/6c3b7c51e463/schema)