# Write.as

> 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.

App · 15 actions. Web page: https://docs.lodol.com/docs/integrations/write-as

## Actions

### 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 (`markdown`, text, required): The text to convert.
- Blog for hashtag links (`blog`, text): Link #hashtags to this blog's tag pages. Leave empty to leave them as text.

**Outputs**

- `html` (text): The HTML

**Example output**

```json
{
  "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 (`title`, text, required): The blog's name, shown at its top.
- Alias (`alias`, text): The end of the blog's address, such as field-notes. Made from the title when empty.

**Outputs**

- `blog` (object): The blog

**Example output**

```json
{
  "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 (`blog`, text, required): 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**

- `blog` (text): The alias of the blog
- `deleted` (true/false): True once deleted

**Example output**

```json
{
  "blog": "field-notes",
  "deleted": true
}
```

### Delete post

Delete a post for good.

**Inputs**

- Post (`post`, text, required): 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_token`, text): Only for a post published without an account: the 'token' that 'Publish post' returned. Leave empty for your account's posts.

**Outputs**

- `deleted` (true/false): True once deleted
- `post_id` (text): The post deleted

**Example output**

```json
{
  "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 (`blog`, text, required): 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**

- `blog` (object): The blog

**Example output**

```json
{
  "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 (`post`, text, required): 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**

- `post` (object): The post

**Example output**

```json
{
  "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 (`blog`, text, required): 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 (`page`, number): Which page of ten. 1 is the newest posts. From 1 to 100000.

**Outputs**

- `blog` (object): The blog
- `count` (number): How many
- `has_more` (true/false): Whether there's another page after this one
- `page` (number): The page returned
- `posts` (list): This page's posts

**Example output**

```json
{
  "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**

- `blogs` (list): Your blogs
- `count` (number): How many

**Example output**

```json
{
  "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**

- `count` (number): How many
- `posts` (list): Your posts

**Example output**

```json
{
  "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 (`blog`, text, required): 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_id`, text, required): The post's id, from 'Publish post', 'List blog posts' or 'List my posts'.

**Outputs**

- `post` (object): The post

**Example output**

```json
{
  "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 (`blog`, text, required): 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_id`, text, required): The post's id, from 'Publish post', 'List blog posts' or 'List my posts'.
- Position (`position`, number): Where among the pinned links, 1 being first. Last when empty. From 1 to 100.

**Outputs**

- `blog` (text): The blog's alias
- `pinned` (true/false): True once pinned
- `post_id` (text): The post

**Example output**

```json
{
  "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 (`blog`, text): The blog to publish to. Leave empty for a standalone post that isn't in any blog.
- Title (`title`, text): The post's title. Leave empty for a post without one.
- Text (`body`, text, required): What the post says, in Markdown. #hashtags become the post's tags.
- Slug (`slug`, text): For a blog post, the end of its address, such as my-first-post. Made from the title when empty.
- Font (`font`, text): 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 (`language`, text): 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 (`direction`, text): 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 (`created`, date and time): The date the post shows. Leave empty for now. A future date schedules a blog post: it stays hidden until then.

**Outputs**

- `post` (object): The post

**Example output**

```json
{
  "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 (`blog`, text, required): 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_id`, text, required): The post's id, from 'Publish post', 'List blog posts' or 'List my posts'.

**Outputs**

- `blog` (text): The blog's alias
- `pinned` (true/false): False once unpinned
- `post_id` (text): The post

**Example output**

```json
{
  "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 (`blog`, text, required): 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 (`title`, text): A new title. Leave empty to keep it.
- Description (`description`, text): A new description. Leave empty to keep it.
- Custom CSS (`custom_css`, text): CSS that styles the whole blog, replacing what it has. Needs a paid plan on Write.as.

**Outputs**

- `blog` (object): The blog

**Example output**

```json
{
  "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 (`post`, text, required): 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 (`title`, text): A new title. Leave empty to keep it.
- Text (`body`, text): New text, in Markdown. Leave empty to keep it.
- Font (`font`, text): 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 (`language`, text): 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 (`direction`, text): 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_token`, text): Only for a post published without an account: the 'token' that 'Publish post' returned. Leave empty for your account's posts.

**Outputs**

- `post` (object): The post

**Example output**

```json
{
  "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
  }
}
```
