Publish a Markdown document

Accepts either a raw text/markdown body or a JSON body { markdown, title?, visibility?, ttl? }. Anonymous publishing is allowed; with an lp_ key the document is owned by the account.

post/publish

Request

  • Base URL: https://lucid.page
  • URL: https://lucid.page/publish
  • Auth: one of:
    • HTTP bearer
    • API key in query parameter apiKey
    • none

Request body

markdownstring required

Max 1 MB

titlestring nullable
visibility'private' | 'unlisted' | 'public'
ttlinteger

Lifetime in seconds; omit for no expiry

namestring nullable

Response

Published

slugstring required
urlstring required
visibility'private' | 'unlisted' | 'public' required
expires_atstring date-time nullable required
claim_tokenstring

One-time ownership token, returned only for anonymous publishes. Claim the page into an account with POST /api/docs/{slug}/claim.

Changes

No recorded changes to this operation across all 1 revision of this API.