# Wiki.js

> Keep your Wiki.js wiki up to date: publish and update pages from workflows, read a page for an AI step or an email, search the wiki, and tag, move and tidy pages. Start a workflow when a page is added or edited.

App · 8 actions. Web page: https://docs.lodol.com/docs/integrations/wikijs

## Actions

### Create page

Publish a page at a path, such as meeting notes, a report or a policy, written in Markdown or HTML, with tags.

**Inputs**

- Path (`path`, text, required): Where the page lives, which is also its address, such as meetings/2026-11-05. Spaces become hyphens; dots aren't allowed.
- Title (`title`, text, required): The page's title.
- Content (`content`, text, required): What the page says, in the format chosen.
- Format (`content_format`, text): How the content is written. Defaults to Markdown; HTML opens in Wiki.js's visual editor. One of: `markdown`, `html`. Default: `markdown`.
- Description (`description`, text): A short line shown under the title and in search results.
- Tags (`tags`, list): Tags to add, such as meeting or finance.
- Language (`locale`, text): The page's language. Leave blank for the wiki's own language.
- Published (`published`, true/false): Whether people can see the page. Turn off to keep it as a draft only editors see. Defaults to on. Default: `true`.

**Outputs**

- `created_at` (text): When it was added (ISO 8601)
- `created_by` (text): Who added it; empty in a list
- `description` (text): The short description shown under its title
- `editor` (text): The editor it's written in, such as markdown or ckeditor
- `id` (number): The page's ID
- `link` (text): Where it opens in Wiki.js
- `locale` (text): The page's language, such as en
- `path` (text): Where the page lives, such as docs/handbook
- `published` (true/false): Whether people can see it
- `tags` (list): Its tags, in lower case
- `title` (text): The page's title
- `updated_at` (text): When it last changed (ISO 8601)
- `updated_by` (text): Who last changed it; empty in a list

**Example output**

```json
{
  "created_at": "2026-11-05T10:00:00.000Z",
  "created_by": "Ada Lovelace",
  "description": "Notes from the weekly team meeting",
  "editor": "markdown",
  "id": 42,
  "link": "https://wiki.example.com/en/meetings/2026-11-05",
  "locale": "en",
  "path": "meetings/2026-11-05",
  "published": true,
  "tags": [
    "meeting",
    "finance"
  ],
  "title": "Team meeting, 5 November",
  "updated_at": "2026-11-05T10:00:04.000Z",
  "updated_by": "Ada Lovelace"
}
```

### Delete page

Delete a page from Wiki.js. It can't be restored from Lodol.

**Inputs**

- Page (`page`, text, required): The page's ID (a number, such as 42) from another Wiki.js step or the trigger, its path (such as docs/handbook), or its link in Wiki.js.
- Language (`locale`, text): The page's language, when it's named by its path in a wiki with a folder per language. Leave blank for the wiki's own language.

**Outputs**

- `deleted` (true/false): Whether the page was deleted
- `id` (number): The page's ID
- `locale` (text): Its language
- `path` (text): Where it was
- `title` (text): Its title

**Example output**

```json
{
  "deleted": true,
  "id": 42,
  "locale": "en",
  "path": "meetings/2026-11-05",
  "title": "Team meeting, 5 November"
}
```

### Get page

Get a page's details and what it says, as Markdown, HTML or plain text, such as for an AI step or an email.

**Inputs**

- Page (`page`, text, required): The page's ID (a number, such as 42) from another Wiki.js step or the trigger, its path (such as docs/handbook), or its link in Wiki.js.
- Language (`locale`, text): The page's language, when it's named by its path in a wiki with a folder per language. Leave blank for the wiki's own language.
- Format (`content_format`, text): How to give the content. Defaults to Markdown. One of: `markdown`, `html`, `plain_text` (Plain text). Default: `markdown`.

**Outputs**

- `content` (text): What the page says, in the format asked for
- `created_at` (text): When it was added (ISO 8601)
- `created_by` (text): Who added it; empty in a list
- `description` (text): The short description shown under its title
- `editor` (text): The editor it's written in, such as markdown or ckeditor
- `format` (text): The content's format: markdown, html or plain_text
- `id` (number): The page's ID
- `link` (text): Where it opens in Wiki.js
- `locale` (text): The page's language, such as en
- `path` (text): Where the page lives, such as docs/handbook
- `published` (true/false): Whether people can see it
- `tags` (list): Its tags, in lower case
- `title` (text): The page's title
- `updated_at` (text): When it last changed (ISO 8601)
- `updated_by` (text): Who last changed it; empty in a list

**Example output**

```json
{
  "content": "## Decisions\n\n- Close the books on the 30th",
  "created_at": "2026-11-05T10:00:00.000Z",
  "created_by": "Ada Lovelace",
  "description": "Notes from the weekly team meeting",
  "editor": "markdown",
  "format": "markdown",
  "id": 42,
  "link": "https://wiki.example.com/en/meetings/2026-11-05",
  "locale": "en",
  "path": "meetings/2026-11-05",
  "published": true,
  "tags": [
    "meeting",
    "finance"
  ],
  "title": "Team meeting, 5 November",
  "updated_at": "2026-11-05T10:00:04.000Z",
  "updated_by": "Ada Lovelace"
}
```

### List pages

List pages with a tag, in a folder or in a language, most recently updated first.

**Inputs**

- Tag (`tag`, text): Only pages with this tag. Leave blank for every page.
- Folder (`path`, text): Only pages in this folder, such as meetings. Leave blank for every folder.
- Language (`locale`, text): Only pages in this language. Leave blank for every language.
- Order (`sort`, text): Which come first. Defaults to recently updated. One of: `updated` (Recently updated), `created` (Recently added), `title`, `path`. Default: `updated`.
- How many (`limit`, number): The most to list. Defaults to 25. From 1 to 100.

**Outputs**

- `count` (number): How many are listed
- `pages` (list): The pages
- `total` (number): How many there are in all

**Example output**

```json
{
  "count": 1,
  "pages": [
    {
      "created_at": "2026-11-05T10:00:00.000Z",
      "created_by": "Ada Lovelace",
      "description": "Notes from the weekly team meeting",
      "editor": "markdown",
      "id": 42,
      "link": "https://wiki.example.com/en/meetings/2026-11-05",
      "locale": "en",
      "path": "meetings/2026-11-05",
      "published": true,
      "tags": [
        "meeting",
        "finance"
      ],
      "title": "Team meeting, 5 November",
      "updated_at": "2026-11-05T10:00:04.000Z",
      "updated_by": "Ada Lovelace"
    }
  ],
  "total": 1
}
```

### List tags

List every tag used on the wiki's pages, A to Z.

**Inputs**: None.

**Outputs**

- `count` (number): How many are listed
- `tags` (list): The tags

**Example output**

```json
{
  "count": 1,
  "tags": [
    {
      "link": "https://wiki.example.com/t/finance",
      "tag": "finance",
      "title": "Finance"
    }
  ]
}
```

### Move page

Move or rename a page by giving it a new path, or move it into another language. Its old address stops working.

**Inputs**

- Page (`page`, text, required): The page's ID (a number, such as 42) from another Wiki.js step or the trigger, its path (such as docs/handbook), or its link in Wiki.js.
- Language (`locale`, text): The page's language, when it's named by its path in a wiki with a folder per language. Leave blank for the wiki's own language.
- New path (`new_path`, text, required): Where the page goes, such as meetings/archive/2026-11-05.
- New language (`new_locale`, text): A language to move it into. Leave blank to keep its language.

**Outputs**

- `created_at` (text): When it was added (ISO 8601)
- `created_by` (text): Who added it; empty in a list
- `description` (text): The short description shown under its title
- `editor` (text): The editor it's written in, such as markdown or ckeditor
- `id` (number): The page's ID
- `link` (text): Where it opens in Wiki.js
- `locale` (text): The page's language, such as en
- `old_path` (text): Where the page was before
- `path` (text): Where the page lives, such as docs/handbook
- `published` (true/false): Whether people can see it
- `tags` (list): Its tags, in lower case
- `title` (text): The page's title
- `updated_at` (text): When it last changed (ISO 8601)
- `updated_by` (text): Who last changed it; empty in a list

**Example output**

```json
{
  "created_at": "2026-11-05T10:00:00.000Z",
  "created_by": "Ada Lovelace",
  "description": "Notes from the weekly team meeting",
  "editor": "markdown",
  "id": 42,
  "link": "https://wiki.example.com/en/meetings/archive/2026-11-05",
  "locale": "en",
  "old_path": "meetings/2026-11-05",
  "path": "meetings/archive/2026-11-05",
  "published": true,
  "tags": [
    "meeting",
    "finance"
  ],
  "title": "Team meeting, 5 November",
  "updated_at": "2026-11-05T10:00:04.000Z",
  "updated_by": "Ada Lovelace"
}
```

### Search pages

Find published pages with the wiki's own search, best match first.

**Inputs**

- Search for (`query`, text, required): Words to find. Wiki.js's built-in search looks in titles, descriptions and paths; the search engine an admin chooses may look in the text too.
- Folder (`path`, text): Only pages whose path starts with this, such as docs. Leave blank to search everywhere.
- Language (`locale`, text): Only pages in this language. Leave blank for every language.
- How many (`limit`, number): The most to list. Defaults to 25. From 1 to 100.

**Outputs**

- `count` (number): How many are listed
- `results` (list): The pages found, best match first
- `total` (number): How many there are in all

**Example output**

```json
{
  "count": 1,
  "results": [
    {
      "description": "Notes from the weekly team meeting",
      "id": 42,
      "link": "https://wiki.example.com/en/meetings/2026-11-05",
      "locale": "en",
      "path": "meetings/2026-11-05",
      "title": "Team meeting, 5 November"
    }
  ],
  "total": 1
}
```

### Update page

Change a page's content, by replacing it or adding to the end, its title, description or tags, or whether it's published. Fields left blank keep what the page has.

**Inputs**

- Page (`page`, text, required): The page's ID (a number, such as 42) from another Wiki.js step or the trigger, its path (such as docs/handbook), or its link in Wiki.js.
- Language (`locale`, text): The page's language, when it's named by its path in a wiki with a folder per language. Leave blank for the wiki's own language.
- Content (`content`, text): The new content, in the format chosen. Leave blank to keep it.
- Format (`content_format`, text): How the content is written. Defaults to Markdown, which is turned into HTML for a page in the visual editor. One of: `markdown`, `html`. Default: `markdown`.
- Replace or add (`mode`, text): Whether the content replaces what the page says, or is added to the end of it, such as for a running log. One of: `replace` (Replace the content), `append` (Add to the end). Default: `replace`.
- Title (`title`, text): A new title. Leave blank to keep it.
- Description (`description`, text): A new description. Leave blank to keep it.
- Tags (`tags`, list): Tags that replace the page's tags. Leave blank to keep them.
- Add tags (`add_tags`, list): Tags to add, keeping the ones the page has, such as reviewed.
- Published (`published`, text): Publish the page, or hide it from everyone but editors. Leave blank to keep it as it is. One of: `published`, `unpublished` (Not published).

**Outputs**

- `created_at` (text): When it was added (ISO 8601)
- `created_by` (text): Who added it; empty in a list
- `description` (text): The short description shown under its title
- `editor` (text): The editor it's written in, such as markdown or ckeditor
- `id` (number): The page's ID
- `link` (text): Where it opens in Wiki.js
- `locale` (text): The page's language, such as en
- `path` (text): Where the page lives, such as docs/handbook
- `published` (true/false): Whether people can see it
- `tags` (list): Its tags, in lower case
- `title` (text): The page's title
- `updated_at` (text): When it last changed (ISO 8601)
- `updated_by` (text): Who last changed it; empty in a list

**Example output**

```json
{
  "created_at": "2026-11-05T10:00:00.000Z",
  "created_by": "Ada Lovelace",
  "description": "Notes from the weekly team meeting",
  "editor": "markdown",
  "id": 42,
  "link": "https://wiki.example.com/en/meetings/2026-11-05",
  "locale": "en",
  "path": "meetings/2026-11-05",
  "published": true,
  "tags": [
    "meeting",
    "finance"
  ],
  "title": "Team meeting, 5 November",
  "updated_at": "2026-11-05T10:00:04.000Z",
  "updated_by": "Ada Lovelace"
}
```
