# Persist the new-publication composer recovery point



URL: /docs/reference/publications/savePublicationComposerDraft

```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}/publication-composer-draft":{"put":{"operationId":"savePublicationComposerDraft","summary":"Persist the new-publication composer recovery point","tags":["Publications"],"parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["expectedRevision","content"],"properties":{"expectedRevision":{"type":"integer","minimum":0},"content":{"type":"object","required":["postTitle","postContent","sourceMedia","publicationTargets","publicationTagIds","defaultDeliveryMode","defaultScheduledAt","customizedTargetIds","customizedContentTargetIds","activePublicationTabId"],"properties":{"postTitle":{"type":"string"},"postContent":{"type":"string"},"sourceMedia":{"type":"array","items":{"type":"object","required":["assetId"],"properties":{"assetId":{"type":"string","minLength":1},"accessibilityText":{"type":"string"}}}},"publicationTargets":{"type":"array","items":{"type":"object","required":["id","channelId","content","deliveryMode","scheduledAt"],"properties":{"id":{"type":"string","minLength":1},"channelId":{"type":"string"},"content":{"type":"string"},"deliveryMode":{"type":"string","enum":["manual","automatic"]},"scheduledAt":{"type":"string"}}}},"publicationTagIds":{"type":"array","items":{"type":"string"}},"defaultDeliveryMode":{"type":"string","enum":["manual","automatic"]},"defaultScheduledAt":{"type":"string"},"customizedTargetIds":{"type":"array","items":{"type":"string"}},"customizedContentTargetIds":{"type":"array","items":{"type":"string"}},"activePublicationTabId":{"type":"string"},"activeContentScopeId":{"type":"string"}}}}}},"application/x-www-form-urlencoded":{"schema":{"type":"object","required":["expectedRevision","content"],"properties":{"expectedRevision":{"type":"integer","minimum":0},"content":{"type":"object","required":["postTitle","postContent","sourceMedia","publicationTargets","publicationTagIds","defaultDeliveryMode","defaultScheduledAt","customizedTargetIds","customizedContentTargetIds","activePublicationTabId"],"properties":{"postTitle":{"type":"string"},"postContent":{"type":"string"},"sourceMedia":{"type":"array","items":{"type":"object","required":["assetId"],"properties":{"assetId":{"type":"string","minLength":1},"accessibilityText":{"type":"string"}}}},"publicationTargets":{"type":"array","items":{"type":"object","required":["id","channelId","content","deliveryMode","scheduledAt"],"properties":{"id":{"type":"string","minLength":1},"channelId":{"type":"string"},"content":{"type":"string"},"deliveryMode":{"type":"string","enum":["manual","automatic"]},"scheduledAt":{"type":"string"}}}},"publicationTagIds":{"type":"array","items":{"type":"string"}},"defaultDeliveryMode":{"type":"string","enum":["manual","automatic"]},"defaultScheduledAt":{"type":"string"},"customizedTargetIds":{"type":"array","items":{"type":"string"}},"customizedContentTargetIds":{"type":"array","items":{"type":"string"}},"activePublicationTabId":{"type":"string"},"activeContentScopeId":{"type":"string"}}}}}},"multipart/form-data":{"schema":{"type":"object","required":["expectedRevision","content"],"properties":{"expectedRevision":{"type":"integer","minimum":0},"content":{"type":"object","required":["postTitle","postContent","sourceMedia","publicationTargets","publicationTagIds","defaultDeliveryMode","defaultScheduledAt","customizedTargetIds","customizedContentTargetIds","activePublicationTabId"],"properties":{"postTitle":{"type":"string"},"postContent":{"type":"string"},"sourceMedia":{"type":"array","items":{"type":"object","required":["assetId"],"properties":{"assetId":{"type":"string","minLength":1},"accessibilityText":{"type":"string"}}}},"publicationTargets":{"type":"array","items":{"type":"object","required":["id","channelId","content","deliveryMode","scheduledAt"],"properties":{"id":{"type":"string","minLength":1},"channelId":{"type":"string"},"content":{"type":"string"},"deliveryMode":{"type":"string","enum":["manual","automatic"]},"scheduledAt":{"type":"string"}}}},"publicationTagIds":{"type":"array","items":{"type":"string"}},"defaultDeliveryMode":{"type":"string","enum":["manual","automatic"]},"defaultScheduledAt":{"type":"string"},"customizedTargetIds":{"type":"array","items":{"type":"string"}},"customizedContentTargetIds":{"type":"array","items":{"type":"string"}},"activePublicationTabId":{"type":"string"},"activeContentScopeId":{"type":"string"}}}}}}}},"responses":{"200":{"description":"Response for status 200","content":{"application/json":{"schema":{"type":"object","required":["draft"],"properties":{"draft":{"type":"object","required":["id","projectId","content","revision","createdAt","updatedAt"],"properties":{"id":{"type":"string","minLength":1},"projectId":{"type":"string","minLength":1},"content":{"type":"object","required":["postTitle","postContent","sourceMedia","publicationTargets","publicationTagIds","defaultDeliveryMode","defaultScheduledAt","customizedTargetIds","customizedContentTargetIds","activePublicationTabId"],"properties":{"postTitle":{"type":"string"},"postContent":{"type":"string"},"sourceMedia":{"type":"array","items":{"type":"object","required":["assetId"],"properties":{"assetId":{"type":"string","minLength":1},"accessibilityText":{"type":"string"}}}},"publicationTargets":{"type":"array","items":{"type":"object","required":["id","channelId","content","deliveryMode","scheduledAt"],"properties":{"id":{"type":"string","minLength":1},"channelId":{"type":"string"},"content":{"type":"string"},"deliveryMode":{"type":"string","enum":["manual","automatic"]},"scheduledAt":{"type":"string"}}}},"publicationTagIds":{"type":"array","items":{"type":"string"}},"defaultDeliveryMode":{"type":"string","enum":["manual","automatic"]},"defaultScheduledAt":{"type":"string"},"customizedTargetIds":{"type":"array","items":{"type":"string"}},"customizedContentTargetIds":{"type":"array","items":{"type":"string"}},"activePublicationTabId":{"type":"string"},"activeContentScopeId":{"type":"string"}}},"revision":{"type":"integer","minimum":1},"createdAt":{"type":"integer","minimum":0},"updatedAt":{"type":"integer","minimum":0}}}}}}}},"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"}}}}}}}},"422":{"description":"Response for status 422","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."}]}
```