Publish post now

curl --request POST \
  --url https://api.mymarky.ai/api/businesses/{business_id}/posts/{post_id}/publish \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "restrict_publish_to": [
    "<string>"
  ],
  "restrict_publish_to_integration_ids": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ]
}
'

import requests

url = "https://api.mymarky.ai/api/businesses/{business_id}/posts/{post_id}/publish"

payload = {
    "restrict_publish_to": ["<string>"],
    "restrict_publish_to_integration_ids": ["3c90c3cc-0d44-4b50-8888-8dd25736052a"]
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    restrict_publish_to: ['<string>'],
    restrict_publish_to_integration_ids: ['3c90c3cc-0d44-4b50-8888-8dd25736052a']
  })
};

fetch('https://api.mymarky.ai/api/businesses/{business_id}/posts/{post_id}/publish', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.mymarky.ai/api/businesses/{business_id}/posts/{post_id}/publish",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'restrict_publish_to' => [
        '<string>'
    ],
    'restrict_publish_to_integration_ids' => [
        '3c90c3cc-0d44-4b50-8888-8dd25736052a'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.mymarky.ai/api/businesses/{business_id}/posts/{post_id}/publish"

	payload := strings.NewReader("{\n  \"restrict_publish_to\": [\n    \"<string>\"\n  ],\n  \"restrict_publish_to_integration_ids\": [\n    \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.mymarky.ai/api/businesses/{business_id}/posts/{post_id}/publish")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"restrict_publish_to\": [\n    \"<string>\"\n  ],\n  \"restrict_publish_to_integration_ids\": [\n    \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.mymarky.ai/api/businesses/{business_id}/posts/{post_id}/publish")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"restrict_publish_to\": [\n    \"<string>\"\n  ],\n  \"restrict_publish_to_integration_ids\": [\n    \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n  ]\n}"

response = http.request(request)
puts response.read_body

{
  "id": "<string>",
  "business_id": "<string>",
  "created_at": "<string>",
  "url": "<string>",
  "delivery": "pending",
  "scheduled_posts_url": "<string>",
  "caption": "<string>",
  "status": "<string>",
  "media_urls": [
    "<string>"
  ],
  "media_details": [
    {
      "id": "<string>",
      "url": "<string>",
      "type": "<string>",
      "description": "<string>",
      "transcript": "<string>",
      "duration": 123
    }
  ],
  "design_id": "<string>",
  "cover_media_id": "<string>",
  "video_cover_timestamp_ms": 123,
  "link": "<string>",
  "restrict_publish_to": [
    "<string>"
  ],
  "restrict_publish_to_integration_ids": [
    "<string>"
  ],
  "scheduled_publish_time": "<string>",
  "scheduled_publish_time_local": "<string>",
  "timezone": "<string>",
  "timezone_source": "business",
  "published_at": "<string>",
  "creation_method": "web",
  "metadata": {},
  "signature_id": "<string>",
  "copy_date": "2023-12-25",
  "copy_moment": "<string>",
  "suggested_publish_time": "<string>",
  "suggested_publish_time_local": "<string>",
  "platform_overrides": [
    {
      "platform": "<string>",
      "caption": "<string>",
      "media_urls": [
        "<string>"
      ],
      "title": "<string>",
      "link": "<string>",
      "first_comment": "<string>"
    }
  ],
  "publish_results": [
    {
      "platform": "<string>",
      "status": "<string>",
      "publish_id": "<string>",
      "post_url": "<string>",
      "error_type": "<string>",
      "error_message": "<string>",
      "customer_message": "<string>",
      "customer_fix": "<string>",
      "integration_id": "<string>",
      "updated_at": "<string>"
    }
  ],
  "queue": {
    "queue_id": "<string>",
    "position": 123,
    "estimated_publish_time": "<string>",
    "estimated_publish_time_local": "<string>",
    "queue_runs_dry_at": "<string>",
    "queue_runs_dry_at_local": "<string>",
    "warnings": [
      {
        "field": "<string>",
        "level": "approaching_limit",
        "message": "<string>",
        "code": "<string>"
      }
    ]
  },
  "publish_readiness": {
    "will_publish_to": [
      "<string>"
    ],
    "blocked": [
      {
        "platform": "<string>",
        "integration_id": "<string>",
        "reason": "<string>",
        "message": "<string>",
        "reconnect_url": "<string>"
      }
    ],
    "not_connected": [
      "<string>"
    ]
  },
  "repeating_cron": "<string>",
  "warnings": [
    {
      "field": "<string>",
      "level": "approaching_limit",
      "message": "<string>",
      "code": "<string>"
    }
  ],
  "updated_at": "<string>",
  "revision_id": "<string>"
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "code": "<string>",
  "instance": "<string>",
  "request_id": "<string>",
  "param": "<string>"
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "code": "<string>",
  "instance": "<string>",
  "request_id": "<string>",
  "param": "<string>"
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "code": "<string>",
  "instance": "<string>",
  "request_id": "<string>",
  "param": "<string>"
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "code": "<string>",
  "instance": "<string>",
  "request_id": "<string>",
  "param": "<string>"
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "code": "<string>",
  "instance": "<string>",
  "request_id": "<string>",
  "param": "<string>"
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "code": "<string>",
  "instance": "<string>",
  "request_id": "<string>",
  "param": "<string>"
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "code": "<string>",
  "instance": "<string>",
  "request_id": "<string>",
  "param": "<string>"
}

Posts

Publish post now

Publish a post immediately to its connected platforms.

Fires the publish flow in the background and returns the post right away. get_post shows the final status (PUBLISHED once every targeted platform is done).

Errors: 400 invalid_request: restrict_publish_to_integration_ids names only accounts outside the post’s own restrict_publish_to_integration_ids. A publish can narrow the post’s accounts, never add to them; change the post with update_post first. 401 authentication_required: API key or token is missing, invalid, or revoked. 403 permission_denied: Your plan does not include API access, or this workspace is not in your org. 404 resource_not_found: No post with that ID exists, or it is not in this workspace. 409 CAPTION_HAS_PLACEHOLDER: The caption still has an unfilled [[placeholder]] (a fact only the owner knows). The post is NOT published and is unchanged. Fill it in with update_post, then publish it again. 409 NO_CONNECTED_SOCIALS: No connected account can publish this post (none connected, all need a reconnect, or none can take this content). The post is NOT published and is unchanged. Follow recovery_hint (usually: call connect_social), then publish it again. 429 rate_limit_exceeded: You sent too many requests this minute.

A post created with restrict_publish_to_integration_ids publishes to those accounts only. The response’s publish_readiness lists the platforms the post will publish to and any connected account that won’t get it, with the reason. delivery on a later read says what actually landed.

POST

api

businesses

{business_id}

posts

{post_id}

publish

Publish post now

curl --request POST \
  --url https://api.mymarky.ai/api/businesses/{business_id}/posts/{post_id}/publish \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "restrict_publish_to": [
    "<string>"
  ],
  "restrict_publish_to_integration_ids": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ]
}
'

import requests

url = "https://api.mymarky.ai/api/businesses/{business_id}/posts/{post_id}/publish"

payload = {
    "restrict_publish_to": ["<string>"],
    "restrict_publish_to_integration_ids": ["3c90c3cc-0d44-4b50-8888-8dd25736052a"]
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    restrict_publish_to: ['<string>'],
    restrict_publish_to_integration_ids: ['3c90c3cc-0d44-4b50-8888-8dd25736052a']
  })
};

fetch('https://api.mymarky.ai/api/businesses/{business_id}/posts/{post_id}/publish', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.mymarky.ai/api/businesses/{business_id}/posts/{post_id}/publish",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'restrict_publish_to' => [
        '<string>'
    ],
    'restrict_publish_to_integration_ids' => [
        '3c90c3cc-0d44-4b50-8888-8dd25736052a'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.mymarky.ai/api/businesses/{business_id}/posts/{post_id}/publish"

	payload := strings.NewReader("{\n  \"restrict_publish_to\": [\n    \"<string>\"\n  ],\n  \"restrict_publish_to_integration_ids\": [\n    \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.mymarky.ai/api/businesses/{business_id}/posts/{post_id}/publish")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"restrict_publish_to\": [\n    \"<string>\"\n  ],\n  \"restrict_publish_to_integration_ids\": [\n    \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.mymarky.ai/api/businesses/{business_id}/posts/{post_id}/publish")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"restrict_publish_to\": [\n    \"<string>\"\n  ],\n  \"restrict_publish_to_integration_ids\": [\n    \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n  ]\n}"

response = http.request(request)
puts response.read_body

{
  "id": "<string>",
  "business_id": "<string>",
  "created_at": "<string>",
  "url": "<string>",
  "delivery": "pending",
  "scheduled_posts_url": "<string>",
  "caption": "<string>",
  "status": "<string>",
  "media_urls": [
    "<string>"
  ],
  "media_details": [
    {
      "id": "<string>",
      "url": "<string>",
      "type": "<string>",
      "description": "<string>",
      "transcript": "<string>",
      "duration": 123
    }
  ],
  "design_id": "<string>",
  "cover_media_id": "<string>",
  "video_cover_timestamp_ms": 123,
  "link": "<string>",
  "restrict_publish_to": [
    "<string>"
  ],
  "restrict_publish_to_integration_ids": [
    "<string>"
  ],
  "scheduled_publish_time": "<string>",
  "scheduled_publish_time_local": "<string>",
  "timezone": "<string>",
  "timezone_source": "business",
  "published_at": "<string>",
  "creation_method": "web",
  "metadata": {},
  "signature_id": "<string>",
  "copy_date": "2023-12-25",
  "copy_moment": "<string>",
  "suggested_publish_time": "<string>",
  "suggested_publish_time_local": "<string>",
  "platform_overrides": [
    {
      "platform": "<string>",
      "caption": "<string>",
      "media_urls": [
        "<string>"
      ],
      "title": "<string>",
      "link": "<string>",
      "first_comment": "<string>"
    }
  ],
  "publish_results": [
    {
      "platform": "<string>",
      "status": "<string>",
      "publish_id": "<string>",
      "post_url": "<string>",
      "error_type": "<string>",
      "error_message": "<string>",
      "customer_message": "<string>",
      "customer_fix": "<string>",
      "integration_id": "<string>",
      "updated_at": "<string>"
    }
  ],
  "queue": {
    "queue_id": "<string>",
    "position": 123,
    "estimated_publish_time": "<string>",
    "estimated_publish_time_local": "<string>",
    "queue_runs_dry_at": "<string>",
    "queue_runs_dry_at_local": "<string>",
    "warnings": [
      {
        "field": "<string>",
        "level": "approaching_limit",
        "message": "<string>",
        "code": "<string>"
      }
    ]
  },
  "publish_readiness": {
    "will_publish_to": [
      "<string>"
    ],
    "blocked": [
      {
        "platform": "<string>",
        "integration_id": "<string>",
        "reason": "<string>",
        "message": "<string>",
        "reconnect_url": "<string>"
      }
    ],
    "not_connected": [
      "<string>"
    ]
  },
  "repeating_cron": "<string>",
  "warnings": [
    {
      "field": "<string>",
      "level": "approaching_limit",
      "message": "<string>",
      "code": "<string>"
    }
  ],
  "updated_at": "<string>",
  "revision_id": "<string>"
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "code": "<string>",
  "instance": "<string>",
  "request_id": "<string>",
  "param": "<string>"
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "code": "<string>",
  "instance": "<string>",
  "request_id": "<string>",
  "param": "<string>"
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "code": "<string>",
  "instance": "<string>",
  "request_id": "<string>",
  "param": "<string>"
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "code": "<string>",
  "instance": "<string>",
  "request_id": "<string>",
  "param": "<string>"
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "code": "<string>",
  "instance": "<string>",
  "request_id": "<string>",
  "param": "<string>"
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "code": "<string>",
  "instance": "<string>",
  "request_id": "<string>",
  "param": "<string>"
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "code": "<string>",
  "instance": "<string>",
  "request_id": "<string>",
  "param": "<string>"
}

Authorizations

Authorization

string

header

required

Bearer an mk_live_ API key. A key is ORG-SCOPED: it grants full access to every resource in that organization, with no per-endpoint scoping (see the uid pseudo-permission on each operation). Manage keys at https://app.mymarky.ai.

Headers

Marky-Version

enum<string>

Opt into a dated API version. Omit to stay on the floor (2026-04-08) forever — unpinned clients never break. Pin to a newer date (e.g. 2026-11-03) to receive the newest response shapes. Unknown values fall back to the floor. See https://docs.mymarky.ai for the versioning model.

Available options:

2026-04-08,

2026-07-17,

2026-08-02,

2026-08-04,

2026-08-06,

2026-10-30,

2026-10-31,

2026-11-03

Example:

"2026-11-03"

Path Parameters

business_id

string

required

The workspace ID (a UUID from list_workspaces). Named business_id for backward compatibility; workspaces were called businesses.

post_id

string<uuid>

required

A UUID identifier.

Body

application/json

restrict_publish_to

string[] | null

Restrict publishing to these platforms (e.g. instagram, facebook, linkedIn). Case-insensitive. Omit or set null to publish to ALL connected platforms.

restrict_publish_to_integration_ids

string<uuid>[] | null

Restrict publishing to these exact connected accounts (integration ids from list_connected_social_accounts). Use instead of restrict_publish_to when a workspace has multiple accounts of the same platform and you want specific ones. Omit or set null for platform-level targeting. Cannot be combined with restrict_publish_to in one request.

Response

Publish accepted; firing in background

string

required

Post ID

business_id

string

required

Workspace this post belongs to

created_at

string

required

When the post was created

url

string

required

read-only

Link to view this post in the Marky app (openable/shareable — show it to the user). This is where the post lives in Marky; link is the outbound URL published with the post.

delivery

enum<string> | null

required

What actually reached the platforms, from publish_results: 'delivered' (every platform succeeded), 'partial' (some succeeded, some failed), 'failed' (every platform failed), 'pending' (still in progress). Null when no publish has been attempted. Prefer this over status to tell the user whether a post went out.

Available options:

pending,

delivered,

partial,

failed

scheduled_posts_url

string | null

required

Link to the workspace's scheduled-posts list in the Marky app — where the user sees this post waiting in the lineup. Present once the post is SCHEDULED; null otherwise.

caption

string | null

Post caption text

status

string | null

Post status. One of: NEW (draft awaiting your team's review, incl. freshly generated), DRAFT (approved by a reviewer on your team), REJECTED (declined by a reviewer), SCHEDULED (queued for a future time), PUBLISHED (already posted). DRAFT/REJECTED are your team's review verdicts — Marky does not gate publishing on them. Same values the list_posts status filter accepts.

media_urls

string[] | null

Attached media URLs

media_details

PostMedia · object[] | null

The same attached media as media_urls, in the same order, but with each item's description and transcript. Use this when analysing what content performs: the creative is usually the reason a post did well, and a URL alone tells you nothing about what was in it.

Show child attributes

design_id

string | null

The design attached to this post, if any. Media is derived from this design; edit it with revise_post_design or create_design + a new link.

cover_media_id

string | null

Media id of the cover image shown before this post's video plays. Marky generates one from the first frame when you don't send one.

video_cover_timestamp_ms

integer | null

The frame (milliseconds from the start) TikTok uses as its cover. Null when nobody has chosen a cover for this post.

link

string | null

Clickable destination URL for platforms that support link posts: the Facebook link attachment, the Google Business CTA button, and the Pinterest pin destination. Other platforms ignore it — put links in the caption there. Must be http(s).

restrict_publish_to

string[] | null

Platforms this post is restricted to. Null means ALL connected platforms.

restrict_publish_to_integration_ids

string[] | null

Exact connected accounts (integration ids) this post is restricted to. Null means targeting is platform-level (see restrict_publish_to).

scheduled_publish_time

string | null

The exact time this post is scheduled to publish (set via schedule). Null for drafts, queued posts, and already-published posts.

scheduled_publish_time_local

string | null

The same moment in the workspace's timezone, ready to show a person, e.g. "Wed Sep 23, 6:00 PM MSK". Quote it as-is instead of converting the UTC value.

timezone

string | null

IANA timezone the *_local times are in: the workspace's calendar timezone, or "UTC" when the workspace hasn't set one (see timezone_source).

timezone_source

enum<string> | null

Where timezone came from: business (the workspace's own setting) or unset_utc (no timezone saved yet, so times are shown in UTC).

Available options:

business,

unset_utc

published_at

string | null

When the post was actually published (past timestamp). Null until it publishes.

creation_method

enum<string> | null

Where the post was created: web, mobile, api (REST with an API key), mcp (an MCP client), max (the built-in assistant), onboarding (the first batch for a new workspace), duplicate, recurrence (the next occurrence of a recurring post), backup_fill (a backup copied into an empty queue slot), or internal. Null for posts created before 2026-10-30.

Available options:

web,

mobile,

api,

mcp,

max,

onboarding,

duplicate,

recurrence,

backup_fill,

internal

metadata

Metadata · object | null

Caller-defined string key/value pairs set at create/update time — your own analytics dimensions (e.g. media_type, format, style, hook, topic). Marky returns them verbatim and never interprets them. Keys starting with marky_ are Marky's own (e.g. the copy date below); any you send are dropped.

Show child attributes

signature_id

string | null

The saved signature (e.g. a compliance disclaimer) appended to the caption when this post was created, or null. It is applied once: editing or rescheduling the post never appends it again.

copy_date

string<date> | null

The day this caption is about, read from the caption when it was written: an upcoming holiday of the workspace's country, one of the workspace's events, or an explicit date like 'September 25'. Never 'today'/'tomorrow'. Queueing never places the post after this day. Null when the caption names no date.

copy_moment

string | null

The moment the caption names, e.g. 'National Day'. Null for a plain date.

suggested_publish_time

string | null

When to publish on copy_date: the workspace's first posting-schedule slot that day, else 10:00 local. Offer it as the post's date; schedule with at to use it.

suggested_publish_time_local

string | null

The same moment in the workspace's timezone, ready to show a person, e.g. "Wed Sep 23, 6:00 PM MSK". Quote it as-is instead of converting the UTC value.

platform_overrides

PlatformOverrideModel · object[] | null

Per-platform content overrides on this post, if any. Each platform publishes its override fields where set, the post's own fields otherwise.

Show child attributes

publish_results

PublishResultResponse · object[]

Per-platform publish outcomes — one entry per platform this post was sent to. Poll this until every entry has a terminal status (success or failed) to know publishing is complete.

Show child attributes

queue

QueueInfo · object | null

Daily-queue placement. Present only when the post is in a recurring daily queue (status SCHEDULED with no adhoc_publish_time). Null for drafts, adhoc-scheduled, and published posts.

Show child attributes

publish_readiness

PublishReadiness · object | null

Returned by queue, schedule and publish: which platforms this post will actually publish to, and which connected accounts won't get it and why. Null on reads.

Show child attributes

repeating_cron

string | null

If set, this post repeats: a standard 5-field cron string (e.g. '0 9 * * 1' = every Monday 9am UTC). When it publishes, Marky auto-creates the next occurrence at the next cron time. Null = a one-off post.

warnings

FieldWarning · object[]

Non-blocking notes about this post's captions, e.g. a call-to-action with no link or phone ('cta_without_contact'), or a caption in a different language from the workspace ('language_mismatch'). Empty when there is nothing to fix. Fix them with update_post before the post publishes; they never block anything.

Show child attributes

updated_at

string | null

Last update time

revision_id

string | null

Id of the undo record this write created. Pass it to revert_revisions to put the record back exactly as it was before this call. Set only on the response to a write; null when you read the record.

Generation

Posts

Team review

Stats

Integrations

Workspaces

Topics

Media

Folders

Files

Webhooks

Feedback

Publish post now

Authorizations

Headers

Path Parameters

Body

Response