Write.as
App · 15 actions
Publish to Write.as: post to your blogs or standalone, update, delete and list posts, manage blogs, pin posts, and run a workflow for each new blog post. Works with WriteFreely servers too.
Actions
| Action | What it does |
|---|---|
| Convert Markdown to HTML | Turn Markdown into the HTML Write.as shows for it. |
| Create blog | Create a blog in your account. |
| Delete blog | Delete a blog for good. |
| Delete post | Delete a post for good. |
| Get blog | Get a blog's title, description, address and number of posts. |
| Get post | Get a post's title, text, tags, views and dates, by its id or web address. |
| List blog posts | List a blog's posts, newest first, ten to a page. |
| List my blogs | List your account's blogs. |
| List my posts | List every post your account owns, in blogs or standalone. |
| Move post to blog | Move one of your posts, standalone or in another of your blogs, into a blog. |
| Pin post | Pin a blog post to the blog's header, as a link beside its name, such as an About page. |
| Publish post | Publish a post to one of your blogs, or as a standalone post at its own address. |
| Unpin post | Unpin a post, putting it back among the blog's posts. |
| Update blog | Change a blog's title, description or custom CSS. |
| Update post | Change a post's text, title, font, language or text direction. |
Convert Markdown to HTML
Turn Markdown into the HTML Write.as shows for it. Give a blog to link #hashtags to that blog's tag pages.
Inputs
- Markdown
markdowntextRequired - The text to convert.
- Blog for hashtag links
blogtext - Link #hashtags to this blog's tag pages. Leave empty to leave them as text.
Outputs
htmltext- The HTML
Example output
{
"html": "<p>What happened <em>this</em> week.</p>\n"
}Create blog
Create a blog in your account. More than one blog needs a paid Write.as plan.
Inputs
- Title
titletextRequired - The blog's name, shown at its top.
- Alias
aliastext - The end of the blog's address, such as field-notes. Made from the title when empty.
Outputs
blogobject- The blog
Example output
{
"blog": {
"alias": "field-notes",
"custom_css": "",
"description": "Weekly notes.",
"email": "",
"public": true,
"title": "Field notes",
"total_posts": 0,
"url": "https://write.as/field-notes/",
"views": 120
}
}Delete blog
Delete a blog for good. Its posts aren't deleted: they become standalone posts.
Inputs
- Blog
blogtextRequired - The blog. Pick one of yours, or type a blog's alias, the end of its address (my-blog in write.as/my-blog).
Outputs
blogtext- The alias of the blog
deletedtrue/false- True once deleted
Example output
{
"blog": "field-notes",
"deleted": true
}Delete post
Delete a post for good.
Inputs
- Post
posttextRequired - The post's id (from 'Publish post' or a list step) or its web address, such as https://write.as/my-blog/my-post.
- Post token
post_tokentext - Only for a post published without an account: the 'token' that 'Publish post' returned. Leave empty for your account's posts.
Outputs
deletedtrue/false- True once deleted
post_idtext- The post deleted
Example output
{
"deleted": true,
"post_id": "rf3t35fkax0aw"
}Get blog
Get a blog's title, description, address and number of posts. Works for any public blog.
Inputs
- Blog
blogtextRequired - The blog. Pick one of yours, or type a blog's alias, the end of its address (my-blog in write.as/my-blog).
Outputs
blogobject- The blog
Example output
{
"blog": {
"alias": "jo",
"custom_css": "",
"description": "Weekly notes.",
"email": "",
"public": true,
"title": "Jo's notes",
"total_posts": 1,
"url": "https://write.as/jo/",
"views": 120
}
}Get post
Get a post's title, text, tags, views and dates, by its id or web address.
Inputs
- Post
posttextRequired - The post's id (from 'Publish post' or a list step) or its web address, such as https://write.as/my-blog/my-post.
Outputs
postobject- The post
Example output
{
"post": {
"blog": "jo",
"blog_title": "Jo's notes",
"body": "What happened this week. #notes",
"created": "2026-10-19T09:00:00Z",
"font": "serif",
"id": "rf3t35fkax0aw",
"language": "en",
"right_to_left": false,
"slug": "notes-from-this-week",
"tags": [
"notes"
],
"title": "Notes from this week",
"token": "",
"updated": "2026-10-19T09:00:00Z",
"url": "https://write.as/jo/notes-from-this-week",
"views": 0
}
}List blog posts
List a blog's posts, newest first, ten to a page. Pinned posts show in the blog's header instead, so they aren't listed.
Inputs
- Blog
blogtextRequired - The blog. Pick one of yours, or type a blog's alias, the end of its address (my-blog in write.as/my-blog).
- Page
pagenumber - Which page of ten. 1 is the newest posts.From 1 to 100000.
Outputs
blogobject- The blog
countnumber- How many
has_moretrue/false- Whether there's another page after this one
pagenumber- The page returned
postslist- This page's posts
Example output
{
"blog": {
"alias": "jo",
"custom_css": "",
"description": "Weekly notes.",
"email": "",
"public": true,
"title": "Jo's notes",
"total_posts": 1,
"url": "https://write.as/jo/",
"views": 120
},
"count": 1,
"has_more": false,
"page": 1,
"posts": [
{
"blog": "jo",
"blog_title": "Jo's notes",
"body": "What happened this week. #notes",
"created": "2026-10-19T09:00:00Z",
"font": "serif",
"id": "rf3t35fkax0aw",
"language": "en",
"right_to_left": false,
"slug": "notes-from-this-week",
"tags": [
"notes"
],
"title": "Notes from this week",
"token": "",
"updated": "2026-10-19T09:00:00Z",
"url": "https://write.as/jo/notes-from-this-week",
"views": 0
}
]
}List my blogs
List your account's blogs. Needs an account.
Inputs
None.
Outputs
blogslist- Your blogs
countnumber- How many
Example output
{
"blogs": [
{
"alias": "jo",
"custom_css": "",
"description": "Weekly notes.",
"email": "",
"public": true,
"title": "Jo's notes",
"total_posts": 1,
"url": "https://write.as/jo/",
"views": 120
}
],
"count": 1
}List my posts
List every post your account owns, in blogs or standalone. Needs an account.
Inputs
None.
Outputs
countnumber- How many
postslist- Your posts
Example output
{
"count": 1,
"posts": [
{
"blog": "jo",
"blog_title": "Jo's notes",
"body": "What happened this week. #notes",
"created": "2026-10-19T09:00:00Z",
"font": "serif",
"id": "rf3t35fkax0aw",
"language": "en",
"right_to_left": false,
"slug": "notes-from-this-week",
"tags": [
"notes"
],
"title": "Notes from this week",
"token": "",
"updated": "2026-10-19T09:00:00Z",
"url": "https://write.as/jo/notes-from-this-week",
"views": 0
}
]
}Move post to blog
Move one of your posts, standalone or in another of your blogs, into a blog.
Inputs
- Blog
blogtextRequired - The blog. Pick one of yours, or type a blog's alias, the end of its address (my-blog in write.as/my-blog).
- Post ID
post_idtextRequired - The post's id, from 'Publish post', 'List blog posts' or 'List my posts'.
Outputs
postobject- The post
Example output
{
"post": {
"blog": "jo",
"blog_title": "Jo's notes",
"body": "What happened this week. #notes",
"created": "2026-10-19T09:00:00Z",
"font": "serif",
"id": "rf3t35fkax0aw",
"language": "en",
"right_to_left": false,
"slug": "notes-from-this-week",
"tags": [
"notes"
],
"title": "Notes from this week",
"token": "",
"updated": "2026-10-19T09:00:00Z",
"url": "https://write.as/jo/notes-from-this-week",
"views": 0
}
}Pin post
Pin a blog post to the blog's header, as a link beside its name, such as an About page.
Inputs
- Blog
blogtextRequired - The blog. Pick one of yours, or type a blog's alias, the end of its address (my-blog in write.as/my-blog).
- Post ID
post_idtextRequired - The post's id, from 'Publish post', 'List blog posts' or 'List my posts'.
- Position
positionnumber - Where among the pinned links, 1 being first. Last when empty.From 1 to 100.
Outputs
blogtext- The blog's alias
pinnedtrue/false- True once pinned
post_idtext- The post
Example output
{
"blog": "jo",
"pinned": true,
"post_id": "rf3t35fkax0aw"
}Publish post
Publish a post to one of your blogs, or as a standalone post at its own address. Without an account, the result's token is the only way to change or delete the post later.
Inputs
- Blog
blogtext - The blog to publish to. Leave empty for a standalone post that isn't in any blog.
- Title
titletext - The post's title. Leave empty for a post without one.
- Text
bodytextRequired - What the post says, in Markdown. #hashtags become the post's tags.
- Slug
slugtext - For a blog post, the end of its address, such as my-first-post. Made from the title when empty.
- Font
fonttext - How the post looks. Serif unless you choose another.One of:
serif(Serif (default)),sans(Sans-serif),wrap(Monospace),mono(Monospace, lines not wrapped),code(Code, with syntax highlighting). - Language
languagetext - The language the post is written in.One of:
af(Afrikaans (af)),ar(Arabic (ar)),bg(Bulgarian (bg)),bn(Bengali (bn)),ca(Catalan (ca)),cs(Czech (cs)),cy(Welsh (cy)),da(Danish (da)),de(German (de)),el(Greek (el)), and 41 more. - Text direction
directiontext - Right to left for Arabic, Hebrew and other such languages.One of:
ltr(Left to right),rtl(Right to left (Arabic, Hebrew and others)). - Publish date
createddate and time - The date the post shows. Leave empty for now. A future date schedules a blog post: it stays hidden until then.
Outputs
postobject- The post
Example output
{
"post": {
"blog": "jo",
"blog_title": "Jo's notes",
"body": "What happened this week. #notes",
"created": "2026-10-19T09:00:00Z",
"font": "serif",
"id": "rf3t35fkax0aw",
"language": "en",
"right_to_left": false,
"slug": "notes-from-this-week",
"tags": [
"notes"
],
"title": "Notes from this week",
"token": "",
"updated": "2026-10-19T09:00:00Z",
"url": "https://write.as/jo/notes-from-this-week",
"views": 0
}
}Unpin post
Unpin a post, putting it back among the blog's posts.
Inputs
- Blog
blogtextRequired - The blog. Pick one of yours, or type a blog's alias, the end of its address (my-blog in write.as/my-blog).
- Post ID
post_idtextRequired - The post's id, from 'Publish post', 'List blog posts' or 'List my posts'.
Outputs
blogtext- The blog's alias
pinnedtrue/false- False once unpinned
post_idtext- The post
Example output
{
"blog": "jo",
"pinned": false,
"post_id": "rf3t35fkax0aw"
}Update blog
Change a blog's title, description or custom CSS. Only what you fill in changes.
Inputs
- Blog
blogtextRequired - The blog. Pick one of yours, or type a blog's alias, the end of its address (my-blog in write.as/my-blog).
- Title
titletext - A new title. Leave empty to keep it.
- Description
descriptiontext - A new description. Leave empty to keep it.
- Custom CSS
custom_csstext - CSS that styles the whole blog, replacing what it has. Needs a paid plan on Write.as.
Outputs
blogobject- The blog
Example output
{
"blog": {
"alias": "jo",
"custom_css": "",
"description": "Notes, weekly.",
"email": "",
"public": true,
"title": "Jo's notes",
"total_posts": 1,
"url": "https://write.as/jo/",
"views": 120
}
}Update post
Change a post's text, title, font, language or text direction. Only what you fill in changes.
Inputs
- Post
posttextRequired - The post's id (from 'Publish post' or a list step) or its web address, such as https://write.as/my-blog/my-post.
- Title
titletext - A new title. Leave empty to keep it.
- Text
bodytext - New text, in Markdown. Leave empty to keep it.
- Font
fonttext - A new look for the post. Leave empty to keep it.One of:
serif(Serif (default)),sans(Sans-serif),wrap(Monospace),mono(Monospace, lines not wrapped),code(Code, with syntax highlighting). - Language
languagetext - The language it's written in. Leave empty to keep it.One of:
af(Afrikaans (af)),ar(Arabic (ar)),bg(Bulgarian (bg)),bn(Bengali (bn)),ca(Catalan (ca)),cs(Czech (cs)),cy(Welsh (cy)),da(Danish (da)),de(German (de)),el(Greek (el)), and 41 more. - Text direction
directiontext - Left to right or right to left. Leave empty to keep it.One of:
ltr(Left to right),rtl(Right to left (Arabic, Hebrew and others)). - Post token
post_tokentext - Only for a post published without an account: the 'token' that 'Publish post' returned. Leave empty for your account's posts.
Outputs
postobject- The post
Example output
{
"post": {
"blog": "jo",
"blog_title": "Jo's notes",
"body": "What happened this week. #notes",
"created": "2026-10-19T09:00:00Z",
"font": "serif",
"id": "rf3t35fkax0aw",
"language": "en",
"right_to_left": false,
"slug": "notes-from-this-week",
"tags": [
"notes"
],
"title": "Notes, revised",
"token": "",
"updated": "2026-10-19T09:00:00Z",
"url": "https://write.as/jo/notes-from-this-week",
"views": 0
}
}