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

Delete a page

delete/v1/pages/{page_id}

Permanently deletes a page. This cannot be undone. Only an archived page can be deleted, so archive it first.

Path parameters

Path parameters
ParameterDescription
page_id
string (uuid)required

The page ID.

Responses

  • 204

    The page was deleted.

    No response body.

  • 401

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

    Error body fields
    Fields of the 401 error body of Delete a page
    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.

  • 403

    The key is read-only, the page is not archived, or its owner cannot edit the wiki. Error code: insufficient_scope or forbidden.

    Error body fields
    Fields of the 403 error body of Delete a page
    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 Delete a page
    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 Delete a page
    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 -X DELETE "https://api.slimwiki.com/v1/pages/a3d8f1c6-2b4e-4f7a-8d9c-5e6f7a8b9c0d" \
  -H "Authorization: Bearer $SLIMWIKI_API_KEY"
Response

This response has no body.

Previous

Retrieve a page
GET /v1/pages/{page_id}

Next

Archive a page
POST /v1/pages/{page_id}/archive

SlimWiki Developers

slimwiki.com