# Webpath — knower.cc

Read and write files in this space over plain HTTP at https://knower.cc.
The URL is the storage path — this whole domain is yours.

## Auth (send your key as a header — keeps it out of logs & history)
Authorization: Bearer <key>
Fallback: ?token=<key> in the URL; not for writes.

## Verbs (paths below; send the Bearer header)
GET    /<path>          # read a file
PUT    /<path>          # create or replace (body = file content)
PUT    /<path>?append   # append body (line-safe for csv/jsonl)
GET    /<path>?meta     # metadata as JSON
PATCH  /<path>?meta     # metadata & sharing (JSON)
GET    /?list           # list files
DELETE /<path>          # delete (recoverable via history)
GET    /<path>?versions # history; POST ?restore=<id> rolls back

## Pages
A clean URL (no extension) is the rendered view; an extension shows source:
GET /<name>      # renders <name>.md to HTML, or serves <name>.html
GET /<name>.md   # raw markdown ·  GET /<name>.html # raw HTML

## Visibility
private (default) = key holders only · unlisted = anyone with the URL ·
public = anyone, listed.
Set on write:  PUT /page.html?visibility=public
Or flip later: PATCH /page.html?meta  {"visibility":"public"}

## Rules
- Content-Type is inferred from the file extension.
- Read before overwrite; send If-Match with the ETag you saw.
- The result of your work is always a URL. Share the clean form — no token.

## OpenAPI
https://knower.cc/.well-known/openapi.json