Skip to content
SalesBuilder
Code
See my plan

Content.publish

Puts approved Content live on your Site and every Interface once it passes the checks for its kind.

Action class
publish
Approval
Publishes on its own
Emits
Content.published
Venues
Bing, Google Search Console
Price
Free
More factsFewer facts
POST https://api.sb/{your-domain}/content/{content}/publish

Its Inputs, Outputs, Effects and guards quote the hub’s Content.publish; this page adds what each Venue honors, its limits and a worked call. It is one of the Verbs of Sites and content.

Inputs

NameTypeDefaultMeaning
contentContentRequiredThe draft to publish.

Outputs

FieldTypeWhat null means
contentContentNever null: the published Content.

Effects

Action class

publish: an approval rule on publish can make it wait for your OK

Modes
  • try: Runs every check and returns what would go out, as it would go out; nothing is sent, posted or spent.
  • send: Returns a pending Action at once; Content.published fires when it is done.
  • do: Waits for the Action to finish and returns the record.
Idempotency

Only with a key: the same Idempotency-Key and input return the first Action, and the same key with other input returns 409.

Saved or shared

Agents read it as Markdown; people read it in each locale the Site serves.

Emits

Content.published with { content }

Performed by

Content lead

Price

Free on your own account: the platform charges nothing for the call.

Standing approval

It goes out on its own, inside the Limits of your standing approval: a Mandate you grant once with Mandate.authorize. One approval rule makes it wait for your OK.

On each Venue

VenueAlso sendsFormats
Bingurl as urlList[], ostname as hostResponsive search ad
Google Search ConsoleNone.None.

Each Venue’s caps, review and rate limits are on its integration page, linked from its row. A field marked Not sent is one that Venue has no place for; the call never fails on it.

What try does

AccountWhat try does
Bing WebmasterReturns the URLs IndexNow would receive and the key file it would check; nothing is pushed.
Google Search ConsoleReads run for real, because a read changes nothing in Search Console; try stores no rows and submits no sitemap.

Refuses when

GuardRefusesError
content-evalsRefuses Content that fails the Eval suite for its kind.refused

Through a connected account it can also meet the shared account refusals.

When it waits

Returns in one response; nothing waits.

Example

In send mode the call returns its pending Action at once, and Content.published delivers the result.

You, to your agent
Publish the rent-tracking guide.
Response, in send mode
{
  "mode": "send",
  "action": {
    "$id": "https://api.sb/leaseline.app/actions/action_Sd3kQ9vT2w",
    "operation": "Content.publish",
    "status": "pending",
    "reason": "running"
  }
}

To retry, send the same Idempotency-Key: the retry returns the first answer for $0. A new key reads again.

Used by

Page.publish

Previous

Site.publish

Next