Skip to content

Post routes: update

The Post Verbs update as api.sb routes, with inputs, result, refusals and an example.

Reference for Post, one group of Post routes.

Post.update

Changes the given properties of a Post. Verb page.

Text
PATCH /{namespace}/posts/{id}

Path: id. Body, as JSON: the other inputs. Emits Post.updated.

Inputs

InputTypeRequiredDescription
idstringrequiredThe id of the Post.
formatstringThe venue’s format, such as shortVideo or thread.
publishAtdatetimeWhen it goes out.
claimsjsonThe facts it states, each resolving to a record.
reachintegerHow many people saw it, as the venue reports.

Returns

OutputTypeRequiredDescription
postPostrequiredThe Post.

Refuses when

CheckErrorFixThen call
The key is valid, but its scopes do not allow this operation.forbiddenUse a key whose scopes cover the operation, or ask an owner of the namespace to grant them.None.

Example

Terminal
curl -X PATCH https://api.sb/leaseline.app/posts/post_HiXn57rBdP \
  -H "Authorization: Bearer $STARTUP_BUILDER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"publishAt":"2026-10-22T12:00:00Z"}'
JSON
{
  "api": "https://api.sb/leaseline.app",
  "post": {
    "$id": "https://api.sb/leaseline.app/posts/post_HiXn57rBdP",
    "$type": "Post",
    "format": "Example format",
    "status": "draft",
    "publishAt": "2026-10-22T12:00:00Z"
  },
  "action": {
    "$id": "https://api.sb/leaseline.app/actions/act_br07HsG8MG",
    "operation": "Post.update",
    "status": "done"
  },
  "links": {
    "self": "https://api.sb/leaseline.app/actions/act_br07HsG8MG"
  }
}