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 / Accounts

List accounts

get/v1/accounts

Returns every account the key owner is a member of.

Responses

  • 200

    The accounts.

    Fields of the 200 response of List accounts
    FieldDescription
    object
    string

    Always "list".

    data
    object[]
    —
    data[].object
    string

    Always "account".

    data[].id
    string (uuid)

    The account ID.

    data[].name
    string
    —
    data[].slug
    string

    The account part of its SlimWiki URL.

    data[].role
    string

    The key owner's role in the account.

    One of owner, member.

    data[].default_wiki_id
    string (uuid) | nulloptional

    The wiki opened at the account URL.

    has_more
    boolean

    Whether another page of results exists after this one.

  • 401

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

    Error body fields
    Fields of the 401 error body of List accounts
    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 List accounts
    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.

Example

Request
curl "https://api.slimwiki.com/v1/accounts" \
  -H "Authorization: Bearer $SLIMWIKI_API_KEY"
Response
200 · application/json
{
  "object": "list",
  "data": [
    {
      "object": "account",
      "id": "c4a7e2b8-5d3f-4a16-9c0e-7b2f1d8a6e45",
      "name": "Acme",
      "slug": "acme",
      "role": "owner",
      "default_wiki_id": "6f1c2d0e-8a3b-4c5d-9e7f-0a1b2c3d4e5f"
    }
  ],
  "has_more": false
}

Previous

Retrieve the key owner
GET /v1/me

Next

List wikis
GET /v1/wikis

SlimWiki Developers

slimwiki.com