Post
A Post is something a Handle publishes, such as a thread or a short video, with the reach and replies it earns.
Properties
| Property | Type | Required | Description |
|---|---|---|---|
format | string | required | The venue’s format, such as shortVideo or thread. |
publishAt | datetime | When it goes out. | |
status | string | required | Where it stands; a withdrawn Post is kept with its reach and replies. |
claims | json | The facts it states, each resolving to a record. | |
reach | integer | How many people saw it, as the venue reports. |
Object
{
"$id": "https: //api.sb/ quietcopy.com/ posts/ post_1",
"$type": "Post",
"format": "Example format",
"publishAt": "2026-10-22T12: 00: 00Z",
"status": "draft",
"claims": {},
"reach": 1
}Relationships
- A Post has one Handle: every Post goes out from one Handle, so its reach and replies count toward that Handle.
handle, inversepublishes.
Lifecycle
| State | Meaning | Moves to |
|---|---|---|
draft (first) | Written and not on its Handle’s calendar. | scheduled by Post.schedule; published by Post.publish |
scheduled | On its Handle’s calendar for publishAt. | published by Post.publish |
published | Live on its venue, earning reach and replies. | withdrawn by Post.withdraw |
withdrawn | Taken down from its venue, with its record, reach and replies kept. | None: it ends here. |
Verbs
createCreates a Post.POST /{namespace}/postsgetReturns one Post by id.GET /{namespace}/posts/{id}listReturns Posts, newest first, one page at a time.GET /{namespace}/postsupdateChanges the given properties of a Post.PATCH /{namespace}/posts/{id}publishPublish sends a Post out through its Handle once every claim it states resolves to a live record.POST /{namespace}/posts/{post}/publishscheduleSchedule puts a drafted Post on its Handle’s calendar for a set time.POST /{namespace}/posts/{post}/schedulewithdrawWithdraw takes a published Post down from its venue and keeps the record, its reach and its replies.POST /{namespace}/posts/{post}/withdraw
A Post is never deleted: it ends by Post.withdraw, and its records stay.
Permissions
Which Access level may call each Verb. One-way Verbs wait their delay window.
| Operation | owner | admin | member | viewer |
|---|---|---|---|---|
Post.create | Yes | Yes | Yes | No |
Post.get | Yes | Yes | Yes | Yes |
Post.list | Yes | Yes | Yes | Yes |
Post.update | Yes | Yes | Yes | No |
Post.publish | Yes | No | No | No |
Post.schedule | Yes | Yes | Yes | No |
Post.withdraw | Yes | No | No | No |
Call it
Schedule the latest post.Example
A gardening app's Handle publishes a thread on frost dates at 7 a.m. Its one claim resolves to a dataset record, and it reaches 12,000 people with 40 replies.