Posts

Get one post with its per-account delivery state

Returns the full post including free-form metadata and a targets array holding one entry per social account the post fans out to, each with its own status, fire time and error. Use this to check what actually happened after scheduling, since the post-level status is only a coarse summary. A post that is not yours is reported as 404.

get/posts/{postId}

Request

  • Base URL: https://www.juzpost.com/api/cli/v1
  • URL: https://www.juzpost.com/api/cli/v1/posts/{postId}
  • Auth: HTTP bearer

Path parameters

postIdstring uuid required

Id of the post, as returned by POST /posts or GET /posts.

Response

The post and its per-account targets.

idstring uuid required

The post id.

statusstring required

Coarse lifecycle summary. Prefer targets when you need to know the real state per account.

type'text' | 'image' | 'video' | 'story' | 'blog' required

What kind of content the post carries. Anything other than text and blog must have at least one media key before it can be scheduled. blog is a WordPress blog post: title is required and description is the body, HTML sent as written (plain text works, blank lines become paragraphs). The first image is the featured image and any others are added under the body. Images only.

contentstring required

The post body or caption.

mediaUrlsstring[] required

Storage keys of the post's media. Empty when there is none.

coverR2Keystring nullable required

Storage key of the cover image, or null if none was set.

scheduledForstring date-time nullable required

The post-level scheduled fire time, or null if unscheduled.

socialAccountIdsstring[] required

Convenience list of the accounts this post fans out to, the same ids that appear in targets.

createdAtstring date-time required

When the post was created.

updatedAtstring date-time required

When the post was last modified.

Changes

No recorded changes to this operation across all 1 revision of this API.