# Promote the current draft to an immutable target revision



URL: /docs/reference/publications/promotePublicationDraft

```json
{"openapi":"3.0.3","info":{"title":"Postdot API","description":"The HTTP API for the lightweight, self-hosted Postdot publication orchestrator.","version":"0.1.0"},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"Postdot API key","description":"A user-owned Postdot API key sent as `Authorization: Bearer <token>`. Its project scope is limited by the creator’s current access."},"sessionCookie":{"type":"apiKey","in":"cookie","name":"better-auth.session_token","description":"The Better Auth email/password session cookie used by the web application."}},"schemas":{}},"security":[{"bearerAuth":[]},{"sessionCookie":[]}],"tags":[{"name":"System","description":"Service health and runtime information."},{"name":"Access","description":"Instance membership and invitations."},{"name":"Projects","description":"Project lifecycle and access."},{"name":"Channels","description":"Project publication destinations."},{"name":"Posts","description":"Source posts and publication creation."},{"name":"Publications","description":"Publication workflow operations."},{"name":"Taxonomy","description":"Project categories and publication tags."},{"name":"Media","description":"Project media assets and uploads."},{"name":"Settings","description":"Instance-level runtime configuration."},{"name":"Audit","description":"Project audit history."},{"name":"Notifications","description":"Signed-in user notification inboxes with optional project context."},{"name":"Analytics","description":"Provider-neutral publication and execution analytics."},{"name":"Provider Analytics","description":"Persisted provider-owned metric observations."}],"paths":{"/api/projects/{projectId}/publications/{publicationId}/draft/promote":{"post":{"operationId":"promotePublicationDraft","summary":"Promote the current draft to an immutable target revision","tags":["Publications"],"parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"publicationId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["expectedRevision"],"properties":{"expectedRevision":{"type":"integer","minimum":1},"scheduledAt":{"anyOf":[{"type":"integer","minimum":0},{"type":"null"}]}}}},"application/x-www-form-urlencoded":{"schema":{"type":"object","required":["expectedRevision"],"properties":{"expectedRevision":{"type":"integer","minimum":1},"scheduledAt":{"anyOf":[{"type":"integer","minimum":0},{"type":"null"}]}}}},"multipart/form-data":{"schema":{"type":"object","required":["expectedRevision"],"properties":{"expectedRevision":{"type":"integer","minimum":1},"scheduledAt":{"anyOf":[{"type":"integer","minimum":0},{"type":"null"}]}}}}}},"responses":{"200":{"description":"Response for status 200","content":{"application/json":{"schema":{"type":"object","required":["editor"],"properties":{"editor":{"type":"object","required":["publication","post","channel","profile","draft","selectedTarget"],"properties":{"publication":{"allOf":[{"type":"object","required":["id","projectId","postId","channelId","targetRevisionId","deliveryMode","reviewState","state","scheduledAt","publishedAt","externalId","externalUrl","errorMessage","createdByActorId","scheduledByActorId","stateChangedByActorId","publishedByActorId","lastAssessedProfileVersionId","createdAt","updatedAt"],"properties":{"id":{"type":"string"},"projectId":{"type":"string"},"postId":{"type":"string"},"channelId":{"type":"string"},"targetRevisionId":{"anyOf":[{"type":"string"},{"type":"null"}]},"deliveryMode":{"enum":["manual","automatic"]},"reviewState":{"enum":["compatible","review_required"]},"state":{"enum":["draft","scheduled","ready","publishing","published","failed","ambiguous","cancelled"]},"scheduledAt":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"publishedAt":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"externalId":{"anyOf":[{"type":"string"},{"type":"null"}]},"externalUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"errorMessage":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdByActorId":{"type":"string"},"scheduledByActorId":{"anyOf":[{"type":"string"},{"type":"null"}]},"stateChangedByActorId":{"type":"string"},"publishedByActorId":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastAssessedProfileVersionId":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"updatedAt":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}}},{"type":"object","required":["profileAssessmentIssues"],"properties":{"profileAssessmentIssues":{"type":"array","items":{"type":"object","patternProperties":{"^.*$":{}}}}}}]},"post":{"type":"object","required":["id","projectId","title","sourceContent","sourceRevision","createdByActorId","createdAt","updatedAt"],"properties":{"id":{"type":"string"},"projectId":{"type":"string"},"title":{"anyOf":[{"type":"string"},{"type":"null"}]},"sourceContent":{"anyOf":[{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"}]},{"type":"array","items":{}},{"type":"object","patternProperties":{"^(.*)$":{}}}]},"sourceRevision":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"createdByActorId":{"type":"string"},"createdAt":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"updatedAt":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}}},"channel":{"allOf":[{"type":"object","required":["id","projectId","name","profileVersionId","state","archivedAt","revision","createdAt","updatedAt"],"properties":{"id":{"type":"string"},"projectId":{"type":"string"},"name":{"type":"string"},"profileVersionId":{"type":"string"},"state":{"enum":["active","archived"]},"archivedAt":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"revision":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"createdAt":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"updatedAt":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}}},{"type":"object","required":["profileId"],"properties":{"profileId":{"type":"string","minLength":1}}}]},"profile":{"type":"object","required":["id","projectId","channelId","profileId","version","origin","state","revision","profile","createdByActorId","createdAt","updatedAt"],"properties":{"id":{"type":"string","minLength":1},"projectId":{"type":"string","minLength":1},"channelId":{"type":"string","minLength":1},"profileId":{"type":"string","minLength":1},"version":{"type":"integer","minimum":1},"origin":{"type":"string","enum":["built_in","custom"]},"state":{"type":"string","enum":["draft","active","superseded","disabled"]},"revision":{"type":"integer","minimum":1},"profile":{"type":"object","patternProperties":{"^.*$":{}}},"createdByActorId":{"type":"string","minLength":1},"createdAt":{"type":"integer","minimum":0},"updatedAt":{"type":"integer","minimum":0}}},"draft":{"type":"object","required":["id","projectId","publicationId","profileVersionId","sourceRevision","baseSourceContent","content","reviewState","validationIssues","lastAssessedProfileVersionId","revision","updatedByActorId","createdAt","updatedAt"],"properties":{"id":{"type":"string","minLength":1},"projectId":{"type":"string","minLength":1},"publicationId":{"type":"string","minLength":1},"profileVersionId":{"type":"string","minLength":1},"sourceRevision":{"type":"integer","minimum":1},"baseSourceContent":{"type":"object","required":["media"],"properties":{"body":{"type":"object","required":["text","format"],"properties":{"text":{"type":"string","minLength":1,"maxLength":1000000},"format":{"type":"string","enum":["plain_text","markdown"]}},"additionalProperties":false},"headline":{"type":"string","minLength":1,"maxLength":10000},"language":{"type":"string","minLength":2,"maxLength":35},"media":{"type":"array","items":{"type":"object","required":["assetId"],"properties":{"assetId":{"type":"string","minLength":1,"maxLength":255},"accessibilityText":{"type":"string","minLength":1,"maxLength":10000}},"additionalProperties":false},"maxItems":256}},"additionalProperties":false},"content":{"type":"object","patternProperties":{"^.*$":{}}},"reviewState":{"type":"string","enum":["compatible","review_required"]},"validationIssues":{"type":"array","items":{"type":"object","patternProperties":{"^.*$":{}}}},"lastAssessedProfileVersionId":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"revision":{"type":"integer","minimum":1},"updatedByActorId":{"type":"string","minLength":1},"createdAt":{"type":"integer","minimum":0},"updatedAt":{"type":"integer","minimum":0}}},"adoptionCount":{"type":"integer","minimum":0},"selectedTargetProfile":{"anyOf":[{"type":"object","required":["id","projectId","channelId","profileId","version","origin","state","revision","profile","createdByActorId","createdAt","updatedAt"],"properties":{"id":{"type":"string","minLength":1},"projectId":{"type":"string","minLength":1},"channelId":{"type":"string","minLength":1},"profileId":{"type":"string","minLength":1},"version":{"type":"integer","minimum":1},"origin":{"anyOf":[{"type":"string","const":"built_in"},{"type":"string","const":"custom"}]},"state":{"anyOf":[{"type":"string","const":"draft"},{"type":"string","const":"active"},{"type":"string","const":"superseded"},{"type":"string","const":"disabled"}]},"revision":{"type":"integer","minimum":1},"profile":{"type":"object","patternProperties":{"^.*$":{}}},"createdByActorId":{"type":"string","minLength":1},"createdAt":{"type":"integer","minimum":0},"updatedAt":{"type":"integer","minimum":0}}},{"type":"null"}]},"selectedTarget":{"anyOf":[{"type":"object","required":["id","projectId","publicationId","sequence","profileVersionId","sourceRevision","deliveryMode","mediaReferenceCount","content","contentHash","profileHash","schemaHash","validationIssues","createdByActorId","createdAt"],"properties":{"id":{"type":"string","minLength":1},"projectId":{"type":"string","minLength":1},"publicationId":{"type":"string","minLength":1},"sequence":{"type":"integer","minimum":1},"profileVersionId":{"type":"string","minLength":1},"sourceRevision":{"type":"integer","minimum":1},"deliveryMode":{"anyOf":[{"type":"string","const":"manual"},{"type":"string","const":"automatic"}]},"mediaReferenceCount":{"type":"integer","minimum":0},"content":{"type":"object","patternProperties":{"^.*$":{}}},"contentHash":{"type":"string","minLength":1},"profileHash":{"type":"string","minLength":1},"schemaHash":{"type":"string","minLength":1},"validationIssues":{"type":"array","items":{"type":"object","patternProperties":{"^.*$":{}}}},"createdByActorId":{"type":"string","minLength":1},"createdAt":{"type":"integer","minimum":0}}},{"type":"null"}]}}}}}}}},"400":{"description":"Response for status 400","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"401":{"description":"Response for status 401","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"403":{"description":"Response for status 403","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"404":{"description":"Response for status 404","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"409":{"description":"Response for status 409","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}}},"servers":[{"url":"https://postbot.example","description":"Replace with your Postdot instance origin."}]}
```