# DokuWiki

> Keep your DokuWiki up to date: save and append to pages from workflows, read a page as wiki text or HTML, search the wiki, follow its recent changes and revisions, and upload or download media files. Start a workflow when a page is created or changed, or a media file is uploaded.

App · 22 actions. Web page: https://docs.lodol.com/docs/integrations/dokuwiki

## Actions

### Append to page

Add text to the end of a page, such as a line in a running log. A page that doesn't exist yet is created.

**Inputs**

- Page (`page`, text, required): The page's ID, such as team:handbook, or its link in the wiki.
- Text (`text`, text, required): The text to add, in DokuWiki's wiki syntax. It starts on a new line.
- Summary (`summary`, text): A short note on what changed, shown in the page's revisions.
- Minor edit (`minor`, true/false): Mark the save as a minor edit, which the wiki leaves out of its change notifications. Default: `false`.

**Outputs**

- `author` (text): The login of who saved it; empty in a list
- `hash` (text): An MD5 hash of its text, to tell whether it changed
- `id` (text): The page's ID, such as team:handbook
- `modified_at` (text): When it was saved (ISO 8601, UTC)
- `namespace` (text): The namespace it is in, such as team; empty at the top
- `permission` (text): What the connected user may do with it: none, read, edit, create, upload, delete or admin, each including the ones before it
- `permission_level` (number): DokuWiki's number for that permission: 0, 1, 2, 4, 8, 16 or 255 for an admin
- `revision` (number): The revision's number: when it was saved, in seconds
- `size` (number): Its size in bytes
- `title` (text): The page's title: its first heading if the wiki shows headings as titles, otherwise its ID
- `url` (text): Its link in the wiki

**Example output**

```json
{
  "author": "ada",
  "hash": "2180b7e42bccbade09859a3d320ea17b",
  "id": "team:handbook",
  "modified_at": "2026-11-17T00:50:17Z",
  "namespace": "team",
  "permission": "upload",
  "permission_level": 8,
  "revision": 1794876617,
  "size": 214,
  "title": "Team Handbook",
  "url": "https://example.com/wiki/doku.php?id=team:handbook"
}
```

### Check permission

Check what the connected user may do with a page or a media file under the wiki's access rules: read, edit, create, upload or delete.

**Inputs**

- Page (`page`, text, required): The ID of a page or a media file, such as team:handbook, or of one that doesn't exist yet.

**Outputs**

- `can_create` (true/false): Whether they may create a page there
- `can_delete` (true/false): Whether they may delete media files there
- `can_edit` (true/false): Whether they may edit a page there
- `can_read` (true/false): Whether the connected user may read it
- `can_upload` (true/false): Whether they may upload media files there
- `id` (text): The ID that was checked
- `permission` (text): What the connected user may do with it: none, read, edit, create, upload, delete or admin, each including the ones before it
- `permission_level` (number): DokuWiki's number for that permission: 0, 1, 2, 4, 8, 16 or 255 for an admin

**Example output**

```json
{
  "can_create": true,
  "can_delete": false,
  "can_edit": true,
  "can_read": true,
  "can_upload": true,
  "id": "team:handbook",
  "permission": "upload",
  "permission_level": 8
}
```

### Delete media file

Delete a media file. The wiki refuses while a page still shows or links to it, and the connected user needs the Delete permission in its namespace.

**Inputs**

- Media file (`media`, text, required): The file's ID, such as team:reports:q3.pdf, or its link in the wiki.

**Outputs**

- `deleted` (true/false): True once it is deleted
- `id` (text): The ID of the file deleted

**Example output**

```json
{
  "deleted": true,
  "id": "team:reports:q3.pdf"
}
```

### Delete page

Delete a page. Its old revisions stay in the wiki, where the page can be restored from them.

**Inputs**

- Page (`page`, text, required): The page's ID, such as team:handbook, or its link in the wiki.
- Summary (`summary`, text): A short note on what changed, shown in the page's revisions.

**Outputs**

- `deleted` (true/false): True once it is deleted
- `id` (text): The ID of the page deleted
- `url` (text): Where the page was; its old revisions are still there

**Example output**

```json
{
  "deleted": true,
  "id": "team:old-notes",
  "url": "https://example.com/wiki/doku.php?id=team:old-notes"
}
```

### Get current user

Get the wiki user the connection acts as, with their groups.

**Inputs**: None.

**Outputs**

- `email` (text): Their email address
- `groups` (list): The groups they are in
- `is_admin` (true/false): Whether they are a wiki admin
- `is_manager` (true/false): Whether they are a wiki manager
- `login` (text): The user's login name
- `name` (text): Their full name

**Example output**

```json
{
  "email": "ada@example.com",
  "groups": [
    "user"
  ],
  "is_admin": false,
  "is_manager": false,
  "login": "ada",
  "name": "Ada Lovelace"
}
```

### Get media file

Download a media file from the wiki, to attach to an email or hand to another step.

**Inputs**

- Media file (`media`, text, required): The file's ID, such as team:reports:q3.pdf, or its link in the wiki.
- Revision (`revision`, text): An older revision of the file: its revision number from another DokuWiki step, or the date and time it was saved. Leave blank for the current one.

**Outputs**

- `content_type` (text): The file's type, such as application/pdf
- `document_ref` (text): The downloaded file, to hand to another step
- `document_url` (text): A link to the downloaded file in Lodol
- `filename` (text): The file's name
- `id` (text): The file's ID in the wiki
- `modified_at` (text): When that revision was saved (ISO 8601, UTC)
- `revision` (number): The revision downloaded
- `size_bytes` (number): Its size in bytes
- `url` (text): Its link in the wiki, for someone signed in there

**Example output**

```json
{
  "content_type": "application/pdf",
  "document_ref": "doc_0123456789abcdef0123456789abcdef",
  "document_url": "/actions/core/serve-document/doc_0123456789abcdef0123456789abcdef",
  "filename": "q3.pdf",
  "id": "team:reports:q3.pdf",
  "modified_at": "2026-11-17T00:51:12Z",
  "revision": 1794876672,
  "size_bytes": 48213,
  "url": "https://example.com/wiki/lib/exe/fetch.php?media=team:reports:q3.pdf"
}
```

### Get media file details

Get a media file's size, when it was last changed and by whom, without downloading it.

**Inputs**

- Media file (`media`, text, required): The file's ID, such as team:reports:q3.pdf, or its link in the wiki.
- Revision (`revision`, text): An older revision of the file: its revision number from another DokuWiki step, or the date and time it was saved. Leave blank for the current one.

**Outputs**

- `author` (text): The login of who saved it; empty in a list
- `hash` (text): An MD5 hash of the file, to tell whether it changed
- `id` (text): The file's ID, such as team:reports:q3.pdf
- `is_image` (true/false): Whether it is an image
- `modified_at` (text): When it was saved (ISO 8601, UTC)
- `name` (text): The file's name, such as q3.pdf
- `namespace` (text): The namespace it is in
- `permission` (text): What the connected user may do with it: none, read, edit, create, upload, delete or admin, each including the ones before it
- `permission_level` (number): DokuWiki's number for that permission: 0, 1, 2, 4, 8, 16 or 255 for an admin
- `revision` (number): The revision's number: when it was saved, in seconds
- `size` (number): Its size in bytes
- `url` (text): Its link in the wiki, for someone signed in there

**Example output**

```json
{
  "author": "ada",
  "hash": "aa784480ced9e2483e062539d8ccf660",
  "id": "team:reports:q3.pdf",
  "is_image": false,
  "modified_at": "2026-11-17T00:51:12Z",
  "name": "q3.pdf",
  "namespace": "team:reports",
  "permission": "upload",
  "permission_level": 8,
  "revision": 1794876672,
  "size": 48213,
  "url": "https://example.com/wiki/lib/exe/fetch.php?media=team:reports:q3.pdf"
}
```

### Get page

Get what a page says, in DokuWiki's wiki syntax, with who last changed it and when. Says whether the page exists rather than failing when it doesn't.

**Inputs**

- Page (`page`, text, required): The page's ID, such as team:handbook, or its link in the wiki.
- Revision (`revision`, text): An older revision of the page: its revision number from another DokuWiki step, or the date and time it was saved. Leave blank for the current one.

**Outputs**

- `author` (text): The login of who saved it; empty in a list
- `exists` (true/false): Whether there is such a page (or such a revision of it)
- `hash` (text): An MD5 hash of its text, to tell whether it changed
- `id` (text): The page's ID, such as team:handbook
- `modified_at` (text): When it was saved (ISO 8601, UTC)
- `namespace` (text): The namespace it is in, such as team; empty at the top
- `permission` (text): What the connected user may do with it: none, read, edit, create, upload, delete or admin, each including the ones before it
- `permission_level` (number): DokuWiki's number for that permission: 0, 1, 2, 4, 8, 16 or 255 for an admin
- `revision` (number): The revision's number: when it was saved, in seconds
- `size` (number): Its size in bytes
- `text` (text): What the page says, in DokuWiki's wiki syntax
- `title` (text): The page's title: its first heading if the wiki shows headings as titles, otherwise its ID
- `url` (text): Its link in the wiki

**Example output**

```json
{
  "author": "ada",
  "exists": true,
  "hash": "2180b7e42bccbade09859a3d320ea17b",
  "id": "team:handbook",
  "modified_at": "2026-11-17T00:50:17Z",
  "namespace": "team",
  "permission": "upload",
  "permission_level": 8,
  "revision": 1794876617,
  "size": 214,
  "text": "====== Team Handbook ======\n\nWelcome to the team.\n",
  "title": "Team Handbook",
  "url": "https://example.com/wiki/doku.php?id=team:handbook"
}
```

### Get page as HTML

Get a page as the wiki shows it, as HTML, such as for an email or an AI step.

**Inputs**

- Page (`page`, text, required): The page's ID, such as team:handbook, or its link in the wiki.
- Revision (`revision`, text): An older revision of the page: its revision number from another DokuWiki step, or the date and time it was saved. Leave blank for the current one.

**Outputs**

- `html` (text): The page as HTML, as the wiki shows it, with whole links
- `id` (text): The page's ID
- `revision` (number): The revision asked for; 0 for the current one
- `url` (text): Its link in the wiki

**Example output**

```json
{
  "html": "<h1 id=\"team_handbook\">Team Handbook</h1>\n<p>Welcome to the team.</p>",
  "id": "team:handbook",
  "revision": 0,
  "url": "https://example.com/wiki/doku.php?id=team:handbook"
}
```

### Get page details

Get who last changed a page and when, its size and what the connected user may do with it, without its text.

**Inputs**

- Page (`page`, text, required): The page's ID, such as team:handbook, or its link in the wiki.
- Revision (`revision`, text): An older revision of the page: its revision number from another DokuWiki step, or the date and time it was saved. Leave blank for the current one.

**Outputs**

- `author` (text): The login of who saved it; empty in a list
- `hash` (text): An MD5 hash of its text, to tell whether it changed
- `id` (text): The page's ID, such as team:handbook
- `modified_at` (text): When it was saved (ISO 8601, UTC)
- `namespace` (text): The namespace it is in, such as team; empty at the top
- `permission` (text): What the connected user may do with it: none, read, edit, create, upload, delete or admin, each including the ones before it
- `permission_level` (number): DokuWiki's number for that permission: 0, 1, 2, 4, 8, 16 or 255 for an admin
- `revision` (number): The revision's number: when it was saved, in seconds
- `size` (number): Its size in bytes
- `title` (text): The page's title: its first heading if the wiki shows headings as titles, otherwise its ID
- `url` (text): Its link in the wiki

**Example output**

```json
{
  "author": "ada",
  "hash": "2180b7e42bccbade09859a3d320ea17b",
  "id": "team:handbook",
  "modified_at": "2026-11-17T00:50:17Z",
  "namespace": "team",
  "permission": "upload",
  "permission_level": 8,
  "revision": 1794876617,
  "size": 214,
  "title": "Team Handbook",
  "url": "https://example.com/wiki/doku.php?id=team:handbook"
}
```

### Get wiki details

Get the wiki's title, its DokuWiki release and the time on its clock.

**Inputs**: None.

**Outputs**

- `api_version` (number): The version of its remote API
- `time` (text): The wiki's clock (ISO 8601, UTC)
- `title` (text): The wiki's title
- `url` (text): The wiki's address
- `version` (text): Its DokuWiki release, such as Release 2025-05-14b "Librarian"

**Example output**

```json
{
  "api_version": 13,
  "time": "2026-11-17T00:52:00Z",
  "title": "Team Wiki",
  "url": "https://example.com/wiki",
  "version": "Release 2025-05-14b \"Librarian\""
}
```

### List backlinks

List the pages that link to a page, such as before renaming or deleting it.

**Inputs**

- Page (`page`, text, required): The page's ID, such as team:handbook, or its link in the wiki.

**Outputs**

- `count` (number): How many there are
- `id` (text): The ID of the page or media file they belong to
- `pages` (list): The pages

**Example output**

```json
{
  "count": 1,
  "id": "team:handbook",
  "pages": [
    {
      "id": "team:policies:leave",
      "url": "https://example.com/wiki/doku.php?id=team:policies:leave"
    }
  ]
}
```

### List media files

List the media files (images, PDFs and other uploads) in a namespace, or in the whole wiki.

**Inputs**

- Namespace (`namespace`, text): The namespace to list, such as team:reports. Leave blank for the top of the wiki.
- Levels deep (`depth`, number): How many levels of namespaces to look in: 1 for the namespace alone, 2 to include the namespaces inside it, 0 for every level. Defaults to 1. From 0 to 100.
- How many (`limit`, number): The most to list. Defaults to 100. From 1 to 1000.

**Outputs**

- `count` (number): How many are listed
- `files` (list): The media files, by ID
- `total` (number): How many there are in all

**Example output**

```json
{
  "count": 1,
  "files": [
    {
      "author": "ada",
      "hash": "aa784480ced9e2483e062539d8ccf660",
      "id": "team:reports:q3.pdf",
      "is_image": false,
      "modified_at": "2026-11-17T00:51:12Z",
      "name": "q3.pdf",
      "namespace": "team:reports",
      "permission": "upload",
      "permission_level": 8,
      "revision": 1794876672,
      "size": 48213,
      "url": "https://example.com/wiki/lib/exe/fetch.php?media=team:reports:q3.pdf"
    }
  ],
  "total": 1
}
```

### List page links

List the links on a page: to other pages, to web addresses and to other wikis.

**Inputs**

- Page (`page`, text, required): The page's ID, such as team:handbook, or its link in the wiki.

**Outputs**

- `count` (number): How many there are
- `id` (text): The ID of the page or media file they belong to
- `links` (list): The links, in the order they appear

**Example output**

```json
{
  "count": 1,
  "id": "team:handbook",
  "links": [
    {
      "target": "team:onboarding",
      "type": "page",
      "url": "https://example.com/wiki/doku.php?id=team:onboarding"
    }
  ]
}
```

### List page revisions

List a page's saves, newest first, with who made each and its summary. Give a revision's number to 'Get page' to read it.

**Inputs**

- Page (`page`, text, required): The page's ID, such as team:handbook, or its link in the wiki.
- Skip (`skip`, number): How many of the newest revisions to pass over, to read further back. The wiki lists 20 at a time unless its admin changed that. At least 0.

**Outputs**

- `count` (number): How many there are
- `id` (text): The ID of the page or media file they belong to
- `revisions` (list): The revisions, newest first

**Example output**

```json
{
  "count": 1,
  "id": "team:handbook",
  "revisions": [
    {
      "author": "ada",
      "change": "edited",
      "id": "team:handbook",
      "modified_at": "2026-11-17T00:50:17Z",
      "namespace": "team",
      "revision": 1794876617,
      "size_change": 43,
      "summary": "Add holidays",
      "url": "https://example.com/wiki/doku.php?id=team:handbook"
    }
  ]
}
```

### List pages

List the pages in a namespace, or in the whole wiki, by ID.

**Inputs**

- Namespace (`namespace`, text): The namespace to list, such as team or team:policies. Leave blank for the top of the wiki.
- Levels deep (`depth`, number): How many levels of namespaces to look in: 1 for the namespace alone, 2 to include the namespaces inside it, 0 for every level. Defaults to 1. From 0 to 100.
- How many (`limit`, number): The most to list. Defaults to 100. From 1 to 1000.

**Outputs**

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

**Example output**

```json
{
  "count": 1,
  "pages": [
    {
      "author": "ada",
      "hash": "2180b7e42bccbade09859a3d320ea17b",
      "id": "team:handbook",
      "modified_at": "2026-11-17T00:50:17Z",
      "namespace": "team",
      "permission": "upload",
      "permission_level": 8,
      "revision": 1794876617,
      "size": 214,
      "title": "Team Handbook",
      "url": "https://example.com/wiki/doku.php?id=team:handbook"
    }
  ],
  "total": 1
}
```

### List pages using a media file

List the pages that show or link to a media file, such as before deleting it. Needs DokuWiki 2025-05-14 or later.

**Inputs**

- Media file (`media`, text, required): The file's ID, such as team:reports:q3.pdf, or its link in the wiki.

**Outputs**

- `count` (number): How many there are
- `id` (text): The ID of the page or media file they belong to
- `pages` (list): The pages

**Example output**

```json
{
  "count": 1,
  "id": "team:reports:q3.pdf",
  "pages": [
    {
      "id": "team:policies:leave",
      "url": "https://example.com/wiki/doku.php?id=team:policies:leave"
    }
  ]
}
```

### List recent media changes

List the media files uploaded, replaced or deleted lately, newest first, each with its latest change.

**Inputs**

- Changed since (`since`, date and time): Only changes made at or after this date and time. Leave blank for everything the wiki keeps as recent, which is seven days unless its admin changed that.
- Namespace (`namespace`, text): Only files in this namespace, such as team, and the namespaces inside it. Leave blank for the whole wiki.

**Outputs**

- `changes` (list): The changes, newest first, one for each page or file
- `count` (number): How many there are

**Example output**

```json
{
  "changes": [
    {
      "author": "ada",
      "change": "created",
      "id": "team:reports:q3.pdf",
      "modified_at": "2026-11-17T00:50:17Z",
      "namespace": "team:reports",
      "revision": 1794876617,
      "size_change": 48213,
      "summary": "created",
      "url": "https://example.com/wiki/lib/exe/fetch.php?media=team:reports:q3.pdf"
    }
  ],
  "count": 1
}
```

### List recent page changes

List the pages changed lately, newest first, each with its latest change: who made it, its summary and whether the page was created, edited or deleted.

**Inputs**

- Changed since (`since`, date and time): Only changes made at or after this date and time. Leave blank for everything the wiki keeps as recent, which is seven days unless its admin changed that.
- Namespace (`namespace`, text): Only pages in this namespace, such as team, and the namespaces inside it. Leave blank for the whole wiki.

**Outputs**

- `changes` (list): The changes, newest first, one for each page or file
- `count` (number): How many there are

**Example output**

```json
{
  "changes": [
    {
      "author": "ada",
      "change": "edited",
      "id": "team:handbook",
      "modified_at": "2026-11-17T00:50:17Z",
      "namespace": "team",
      "revision": 1794876617,
      "size_change": 43,
      "summary": "Add holidays",
      "url": "https://example.com/wiki/doku.php?id=team:handbook"
    }
  ],
  "count": 1
}
```

### Save page

Create a page, or replace what an existing page says. The page keeps its earlier revisions.

**Inputs**

- Page (`page`, text, required): The page's ID, such as team:handbook. A page that doesn't exist yet is created, with its namespaces.
- Text (`text`, text, required): What the page says, in DokuWiki's wiki syntax, such as ====== Title ====== for a heading. It replaces everything on the page.
- Summary (`summary`, text): A short note on what changed, shown in the page's revisions.
- Minor edit (`minor`, true/false): Mark the save as a minor edit, which the wiki leaves out of its change notifications. Default: `false`.

**Outputs**

- `author` (text): The login of who saved it; empty in a list
- `hash` (text): An MD5 hash of its text, to tell whether it changed
- `id` (text): The page's ID, such as team:handbook
- `modified_at` (text): When it was saved (ISO 8601, UTC)
- `namespace` (text): The namespace it is in, such as team; empty at the top
- `permission` (text): What the connected user may do with it: none, read, edit, create, upload, delete or admin, each including the ones before it
- `permission_level` (number): DokuWiki's number for that permission: 0, 1, 2, 4, 8, 16 or 255 for an admin
- `revision` (number): The revision's number: when it was saved, in seconds
- `size` (number): Its size in bytes
- `title` (text): The page's title: its first heading if the wiki shows headings as titles, otherwise its ID
- `url` (text): Its link in the wiki

**Example output**

```json
{
  "author": "ada",
  "hash": "2180b7e42bccbade09859a3d320ea17b",
  "id": "team:handbook",
  "modified_at": "2026-11-17T00:50:17Z",
  "namespace": "team",
  "permission": "upload",
  "permission_level": 8,
  "revision": 1794876617,
  "size": 214,
  "title": "Team Handbook",
  "url": "https://example.com/wiki/doku.php?id=team:handbook"
}
```

### Search pages

Search the text of the wiki's pages the way its search box does, best match first.

**Inputs**

- Search for (`query`, text, required): Words to find, as typed in the wiki's search box. Put a phrase in quotes to find it exactly ("leave policy"), a minus before a word to leave out pages with it, and @team to search only that namespace.
- How many (`limit`, number): The most to list. Defaults to 25. From 1 to 1000.

**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": [
    {
      "id": "team:policies:leave",
      "namespace": "team:policies",
      "score": 3,
      "snippet": "Twenty-five days of annual leave.",
      "title": "Leave policy",
      "url": "https://example.com/wiki/doku.php?id=team:policies:leave"
    }
  ],
  "total": 1
}
```

### Upload media file

Upload a file to the wiki's media, where pages can show or link to it. The wiki takes only the file types its admin allows: images, PDFs and office documents unless that was changed.

**Inputs**

- Media file (`media`, text, required): The ID to save the file under, such as team:reports:q3.pdf, ending the way the file's name does.
- File (`file`, text, required): The file: upload one, pick one from an earlier step, or give a public https link to download.
- Replace existing file (`overwrite`, true/false): Replace a file that already has this ID. Left off, the step fails rather than replace one. Default: `false`.

**Outputs**

- `author` (text): The login of who saved it; empty in a list
- `hash` (text): An MD5 hash of the file, to tell whether it changed
- `id` (text): The file's ID, such as team:reports:q3.pdf
- `is_image` (true/false): Whether it is an image
- `modified_at` (text): When it was saved (ISO 8601, UTC)
- `name` (text): The file's name, such as q3.pdf
- `namespace` (text): The namespace it is in
- `permission` (text): What the connected user may do with it: none, read, edit, create, upload, delete or admin, each including the ones before it
- `permission_level` (number): DokuWiki's number for that permission: 0, 1, 2, 4, 8, 16 or 255 for an admin
- `revision` (number): The revision's number: when it was saved, in seconds
- `size` (number): Its size in bytes
- `url` (text): Its link in the wiki, for someone signed in there

**Example output**

```json
{
  "author": "ada",
  "hash": "aa784480ced9e2483e062539d8ccf660",
  "id": "team:reports:q3.pdf",
  "is_image": false,
  "modified_at": "2026-11-17T00:51:12Z",
  "name": "q3.pdf",
  "namespace": "team:reports",
  "permission": "upload",
  "permission_level": 8,
  "revision": 1794876672,
  "size": 48213,
  "url": "https://example.com/wiki/lib/exe/fetch.php?media=team:reports:q3.pdf"
}
```
