Skip to content
Developers
GuidesAPI reference
slimwiki.comGet an API key

Guides

  • Quickstart
  • Authentication
  • Errors
  • Pagination
  • Rate limits
  • Content format
  • Versioning

Tools and agents

  • CLI
  • MCP server
  • Agent skill

API reference

  • Overview

Users

  • Retrieve the key ownerget

Accounts

  • List accountsget

Wikis

  • List wikisget
  • Retrieve a wikiget

Pages

  • List pages in a wikiget
  • Search pages in a wikiget
  • Find a page by slug or hashget
  • Create a pagepost
  • Retrieve a pageget
  • Delete a pagedelete
  • Archive a pagepost
  • Restore a pagepost

API reference / Pages

Find a page by slug or hash

get/v1/wikis/{wiki_id}/pages/lookup

Returns the page in a wiki with the given slug or hash, with its content. Useful when you have a page URL rather than its ID. Give exactly one of the two.

Path parameters

Path parameters
ParameterDescription
wiki_id
string (uuid)required

The wiki ID.

Query parameters

Query parameters
ParameterDescription
slug
stringoptional

The page slug.

1 to 1024 characters.

hash
stringoptional

The page hash (12 characters).

12 to 12 characters.

Responses

  • 200

    The page.

    Fields of the 200 response of Find a page by slug or hash
    FieldDescription
    object
    string

    Always "page".

    id
    string (uuid)

    The page ID.

    wiki_id
    string (uuid)

    The wiki the page belongs to.

    title
    string
    —
    slug
    string

    The page part of its SlimWiki URL.

    hash
    string | nulloptional

    A short identifier that stays the same when the page is renamed. It is the last part of the page URL.

    archived
    boolean
    —
    created_at
    string (date-time) | nulloptional

    When the page was created.

    updated_at
    string (date-time) | nulloptional

    When the page was last edited.

    content
    ContentNode[]

    The page body as a list of content nodes. See the content format guide.

  • 400

    Neither or both of slug and hash were given. Error code: invalid_request.

    Error body fields
    Fields of the 400 error body of Find a page by slug or hash
    FieldDescription
    error
    object
    —
    error.code
    string

    A stable, machine-readable error code.

    One of invalid_request, unauthorized, insufficient_scope, forbidden, not_found, conflict, rate_limited, internal_error.

    error.message
    string

    A description for people. The wording may change.

    error.details
    object[]optional

    For invalid_request: the fields that failed validation.

    error.details[].field
    stringoptional
    —
    error.details[].message
    stringoptional
    —
    error.request_id
    string | nulloptional

    Quote this when contacting support.

  • 401

    The API key is missing, invalid, revoked or expired. Error code: unauthorized.

    Error body fields
    Fields of the 401 error body of Find a page by slug or hash
    FieldDescription
    error
    object
    —
    error.code
    string

    A stable, machine-readable error code.

    One of invalid_request, unauthorized, insufficient_scope, forbidden, not_found, conflict, rate_limited, internal_error.

    error.message
    string

    A description for people. The wording may change.

    error.details
    object[]optional

    For invalid_request: the fields that failed validation.

    error.details[].field
    stringoptional
    —
    error.details[].message
    stringoptional
    —
    error.request_id
    string | nulloptional

    Quote this when contacting support.

  • 404

    The resource does not exist, or this API key cannot see it. Error code: not_found.

    Error body fields
    Fields of the 404 error body of Find a page by slug or hash
    FieldDescription
    error
    object
    —
    error.code
    string

    A stable, machine-readable error code.

    One of invalid_request, unauthorized, insufficient_scope, forbidden, not_found, conflict, rate_limited, internal_error.

    error.message
    string

    A description for people. The wording may change.

    error.details
    object[]optional

    For invalid_request: the fields that failed validation.

    error.details[].field
    stringoptional
    —
    error.details[].message
    stringoptional
    —
    error.request_id
    string | nulloptional

    Quote this when contacting support.

  • 429

    Rate limit exceeded. See the Retry-After header. Error code: rate_limited.

    Error body fields
    Fields of the 429 error body of Find a page by slug or hash
    FieldDescription
    error
    object
    —
    error.code
    string

    A stable, machine-readable error code.

    One of invalid_request, unauthorized, insufficient_scope, forbidden, not_found, conflict, rate_limited, internal_error.

    error.message
    string

    A description for people. The wording may change.

    error.details
    object[]optional

    For invalid_request: the fields that failed validation.

    error.details[].field
    stringoptional
    —
    error.details[].message
    stringoptional
    —
    error.request_id
    string | nulloptional

    Quote this when contacting support.

Any request can also fail with 500 internal_error. See Errors for every code.

The ContentNode object

One block or inline node of page content, for example a paragraph, heading or text run.

Fields of ContentNode
FieldDescription
type
stringrequired

The node type, such as paragraph, heading, bulletList or text.

attrs
objectoptional

Type-specific attributes, such as a heading level.

content
ContentNode[]optional

Child nodes.

text
stringoptional

The text of a text node.

marks
object[]optional

Inline formatting on a text node, such as bold or link.

The content format guide shows the common node types with examples.

Example

Request
curl "https://api.slimwiki.com/v1/wikis/6f1c2d0e-8a3b-4c5d-9e7f-0a1b2c3d4e5f/pages/lookup" \
  -H "Authorization: Bearer $SLIMWIKI_API_KEY"
Response
200 · application/json
{
  "object": "page",
  "id": "a3d8f1c6-2b4e-4f7a-8d9c-5e6f7a8b9c0d",
  "wiki_id": "6f1c2d0e-8a3b-4c5d-9e7f-0a1b2c3d4e5f",
  "title": "Release checklist",
  "slug": "release-checklist",
  "hash": "string",
  "archived": false,
  "created_at": "2026-01-12T09:30:00.000Z",
  "updated_at": "2026-01-14T16:05:00.000Z",
  "content": [
    {
      "type": "paragraph",
      "content": [
        {
          "type": "text",
          "text": "Steps we follow for every release."
        }
      ]
    }
  ]
}

Previous

Search pages in a wiki
GET /v1/wikis/{wiki_id}/pages/search

Next

Create a page
POST /v1/pages

SlimWiki Developers

slimwiki.com