PostZen
Posts

Get a post

GET
/v1/posts/{postId}

Returns one post when it belongs to a profile available to the API key. Missing and inaccessible posts both return 404.

Authorization

bearerAuth
AuthorizationBearer <token>

PostZen API key.

In: header

Path Parameters

postId*string

PostZen post id.

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/posts/string"
{  "post": {    "_id": "string",    "title": "string",    "content": "string",    "status": "string",    "scheduledFor": "2019-08-24T14:15:22Z",    "queueId": "string",    "timezone": "string",    "platforms": [      {        "platform": "twitter",        "accountId": {          "_id": "string",          "platform": "twitter",          "username": "string",          "displayName": "string",          "isActive": true        },        "status": "draft",        "platformPostUrl": "http://example.com",        "error": "string"      }    ]  }}
{  "error": "JSON body is required"}
{  "error": "Unauthorized"}
{  "error": "Not found"}
{  "error": "rate_limited",  "retryAfter": 30}

Create a post POST

Creates a draft, scheduled post, or immediate post. This endpoint requires a read-write API key. Provide exactly one creation mode: `publishNow`, `scheduledFor`, or `isDraft`.

Update a post PUT

Updates an editable post. Every body field is optional; omitted fields keep their current values, and omitting all timing fields keeps the current scheduling and draft status. At most one of `publishNow`, `scheduledFor`, `isDraft`, or `queuedFromProfile` may select a new timing mode.