POpolytomic
Harbors

List Harbor Context Drafts

Changed on

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.

get/api/harbors/{harbor_id}/contexts/drafts

Request

  • Base URL
    https://app.polytomic.com
  • Auth
    • HTTP bearer
    • or HTTP basic

Path parameters

harbor_idstring uuid required

Unique identifier of the Harbor

Example:248df4b7-aa70-47b8-a036-33ac447e668d

Query parameters

limitinteger

Maximum number of mutable drafts to return. Defaults to 50 and cannot exceed 50.

Example:50
page_tokenstring

Opaque pagination cursor returned by the previous request

Headers

X-Polytomic-Versionstring

Response

OK

Example response

{
  "data": [
    {
      "base_revision_id": "248df4b7-aa70-47b8-a036-33ac447e668d",
      "context_id": "248df4b7-aa70-47b8-a036-33ac447e668d",
      "created_by": "248df4b7-aa70-47b8-a036-33ac447e668d",
      "id": "248df4b7-aa70-47b8-a036-33ac447e668d",
      "updated_by": "248df4b7-aa70-47b8-a036-33ac447e668d"
    }
  ],
  "pagination": {
    "next_page_token": "AmkYh8v0jR5B3kls2Qcc9y8MjrPmvR4CvaK7H0F4rEwqvg76K=="
  }
}

Changes

  • d80b0fdea14eRevision changes
    • breaking

      the response's property type changed from object to no type for status

    • warning

      removed the optional property / from the response with the status

    • info

      added to the response property allOf list for the response status

  • 8d7294388f3fRevision changes
    • info

      endpoint added