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

ActionWhat it does
Convert Markdown to HTMLTurn Markdown into the HTML Write.as shows for it.
Create blogCreate a blog in your account.
Delete blogDelete a blog for good.
Delete postDelete a post for good.
Get blogGet a blog's title, description, address and number of posts.
Get postGet a post's title, text, tags, views and dates, by its id or web address.
List blog postsList a blog's posts, newest first, ten to a page.
List my blogsList your account's blogs.
List my postsList every post your account owns, in blogs or standalone.
Move post to blogMove one of your posts, standalone or in another of your blogs, into a blog.
Pin postPin a blog post to the blog's header, as a link beside its name, such as an About page.
Publish postPublish a post to one of your blogs, or as a standalone post at its own address.
Unpin postUnpin a post, putting it back among the blog's posts.
Update blogChange a blog's title, description or custom CSS.
Update postChange 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

MarkdownmarkdowntextRequired
The text to convert.
Blog for hashtag linksblogtext
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

TitletitletextRequired
The blog's name, shown at its top.
Aliasaliastext
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

BlogblogtextRequired
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

PostposttextRequired
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 tokenpost_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

BlogblogtextRequired
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

PostposttextRequired
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

BlogblogtextRequired
The blog. Pick one of yours, or type a blog's alias, the end of its address (my-blog in write.as/my-blog).
Pagepagenumber
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

BlogblogtextRequired
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 IDpost_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

BlogblogtextRequired
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 IDpost_idtextRequired
The post's id, from 'Publish post', 'List blog posts' or 'List my posts'.
Positionpositionnumber
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

Blogblogtext
The blog to publish to. Leave empty for a standalone post that isn't in any blog.
Titletitletext
The post's title. Leave empty for a post without one.
TextbodytextRequired
What the post says, in Markdown. #hashtags become the post's tags.
Slugslugtext
For a blog post, the end of its address, such as my-first-post. Made from the title when empty.
Fontfonttext
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).
Languagelanguagetext
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 directiondirectiontext
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 datecreateddate 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

BlogblogtextRequired
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 IDpost_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

BlogblogtextRequired
The blog. Pick one of yours, or type a blog's alias, the end of its address (my-blog in write.as/my-blog).
Titletitletext
A new title. Leave empty to keep it.
Descriptiondescriptiontext
A new description. Leave empty to keep it.
Custom CSScustom_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

PostposttextRequired
The post's id (from 'Publish post' or a list step) or its web address, such as https://write.as/my-blog/my-post.
Titletitletext
A new title. Leave empty to keep it.
Textbodytext
New text, in Markdown. Leave empty to keep it.
Fontfonttext
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).
Languagelanguagetext
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 directiondirectiontext
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 tokenpost_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
  }
}

On this page