Postdot
Home
GuidesSelf-hostingDevelopmentAPI reference
Posts

Add unscheduled destination drafts to an existing source post

POST
/api/projects/{projectId}/posts/{postId}/destinations

Authorization

headerAuthorizationBearer <Postdot API key>

A user-owned Postdot API key sent as Authorization: Bearer <token>. Its project scope is limited by the creator’s current access.

Path Parameters

projectId*string
Length1 <= length
postId*string
Length1 <= length

Request Body

  1. body
expectedSourceRevision*integer
Range1 <= value
confirmExistingChannels?boolean
publications*array<>
Items1 <= items <= 100

Response Body

Response for status 201

application/json
  1. response
post*
publications*array<>
Example Request
curl -X POST 'https://postbot.example/api/projects/string/posts/string/destinations' \
  -H 'Content-Type: application/json' \
  -d '{
  "expectedSourceRevision": 1,
  "publications": [
    {
      "channelId": "string",
      "deliveryMode": "manual"
    }
  ]
}'
Example Response
{
  "post": {
    "id": "string",
    "projectId": "string",
    "title": "string",
    "sourceContent": "string",
    "sourceRevision": -9007199254740991,
    "createdByActorId": "string",
    "createdAt": -9007199254740991,
    "updatedAt": -9007199254740991
  },
  "publications": [
    {
      "id": "string",
      "projectId": "string",
      "postId": "string",
      "channelId": "string",
      "targetRevisionId": "string",
      "deliveryMode": "manual",
      "reviewState": "compatible",
      "state": "draft",
      "scheduledAt": -9007199254740991,
      "publishedAt": -9007199254740991,
      "externalId": "string",
      "externalUrl": "string",
      "errorMessage": "string",
      "createdByActorId": "string",
      "scheduledByActorId": "string",
      "stateChangedByActorId": "string",
      "publishedByActorId": "string",
      "lastAssessedProfileVersionId": "string",
      "createdAt": -9007199254740991,
      "updatedAt": -9007199254740991,
      "profileAssessmentIssues": [
        {}
      ]
    }
  ]
}

Was this page helpful?

Update one signed-in user notification preference PATCH

Previous Page

Create a source post and its publications POST

Omitting scheduledAt creates unscheduled destination drafts. API keys need publication:manage; supplying scheduledAt also requires publication:dispatch. Target content must match the chosen channel profile. The examples use placeholder channel IDs that must be replaced.