write_comment_permissions

(string, optional): the nextafter from a previous response. A timestamp, not an

(everyone onlypaid onlyfree founding, optional)

(string): Body of the post. Plain text becomes one paragraph per line — Markdown is not

(array, optional): which columns to include, defaulting to all of them

(string, optional): the social preview image. A URL already on substack-post-media.s3.amazonaws.com or substackcdn.com is used as-is; anything else is downloaded and re-hosted on Substack first, under the same guards as uploadimage

(boolean, optional): create the tag when no name matches. Defaults to true;

(string, optional): the nextcursor from a previous response

ison isafter isonorafter isbefore isonorbefore

(bestfirst mostrecentfirst oldestfirst, optional)

(string, optional): the social preview description — not the subtitle

(number): the id returned by listposts or createdraftpost

(string, optional)

(string, optional)

(array, optional): conditions combined with AND, each {column, operator, value}

(boolean, optional): return all 111 fields (~24 KB) instead of the projection.

(boolean, optional): defaults to true

(boolean, optional): include tags not shown in the navigation. Defaults to true.

(boolean, optional): also return the available tab ids

(number, optional): 1–100, defaults to 25

(number, optional): 1–600, defaulting to 120

(number, optional): for paging

(string): absolute path to an image file on the machine running this server, read straight

(number, optional): the post the image belongs to; its effect is unconfirmed

(string, optional): free text matched against subscriber name and email

(string, optional)

(string, optional)

(boolean, optional): email the post to subscribers. Defaults to false, unlike the

(string, optional): the post's URL slug

(string, optional): the title used when the post is shared elsewhere

(string, optional): any filterable column

(asc desc, optional): defaults to desc

(drafts published scheduled): which list to read

(string): Subtitle of the post

(string, optional): tab id — for-you (default) or subscribed. Never the display name:

(string): matched case-insensitively against existing tags

(string): Title of the post

(string): the http(s) URL of an image to download and re-host

(number, optional): defaults to SUBSTACKUSERID — your own account