Create Harbor Context Draft

Beta
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.

Authentication

AuthorizationBearer
Bearer user API key
OR
AuthorizationBasic

Basic organization-scoped API key

Path parameters

harbor_idstringRequiredformat: "uuid"
Unique identifier of the Harbor.

Headers

X-Polytomic-VersionstringOptional

Request

This endpoint expects an object.
contentstringRequired

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

titlestringRequired

Human-readable draft title. Maximum 200 characters.

change_notestring or nullOptional
Optional note stored with the draft and copied to published version 1 on promotion.
descriptionstringOptional
Short summary of the draft. Maximum 1,000 characters.

Response

OK
dataobjectOptional

Errors

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