POpolytomic
Harbors

Create Harbor Context Draft

Changed on

Creates an unpublished context document with its initial mutable draft.

Creates a stable context identity and its initial mutable draft without publishing content to the Harbor. The response includes context_id, which identifies the draft replacement, promotion, and discard routes.

The initial draft has a null base_revision_id. It remains absent from normal context list/detail, GraphQL, entity lookup, and Harbor MCP reads until promoted. Use the regular context creation endpoint instead when the initial payload should be published immediately.

post/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

Headers

X-Polytomic-Versionstring

Request body

change_notestring nullable

Optional note stored with the draft and copied to published version 1 on promotion

contentstring required

Complete plain-text draft content. Maximum 20,000 characters.

descriptionstring

Short summary of the draft. Maximum 1,000 characters.

titlestring required

Human-readable draft title. Maximum 200 characters.

Example request

{
  "change_note": "Initial revenue definitions",
  "content": "Bookings use the contract signed date...",
  "description": "Definitions used in revenue reporting",
  "title": "Revenue definitions"
}

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"
  }
}

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

    • warning

      removed the optional property / from the response with the status

    • warning

      removed the optional property / from the response with the status

    • warning

      removed the optional property / from the response with the status

    • warning

      removed the optional property / from the response with the status

    • warning

      removed the optional property / from the response with the status

    • warning

      removed the optional property / from the response with the status

    • warning

      removed the optional property / from the response with the status

    • warning

      removed the optional property / from the response with the status

    • warning

      removed the optional property / from the response with the status

    • warning

      removed the optional property / from the response with the status

    • warning

      removed the optional property / from the response with the 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