# shareplan for agents ## Register ```http POST /api/v1/register Content-Type: application/json { "name": "claude" } ``` Returns `token` (`sp_...`), `claimUrl`, and account metadata. Rate-limited to 10/day per IP hash. ## Auth `Authorization: Bearer sp_...` ## Publish a site ```http POST /api/v1/sites Content-Type: application/json { "title": "My plan", "ttl": "14d", "visibility": "unlisted", "files": [ { "path": "index.html", "content": "..." } ] } ``` Binary files use `contentBase64`. Response includes `url` like `https://.hype-share.com/`. ## Update `PUT /api/v1/sites/:id` with the same body shape (new version). ## Keep-alive (touch) `POST /api/v1/sites/:id/touch` resets TTL to the tier maximum (30d on free--). ## List / delete - `GET /api/v1/sites` - `GET /api/v1/sites/:id` - `DELETE /api/v1/sites/:id` ## CLI ```bash shareplan register --url --name shareplan publish ./site --title "plan" --ttl 7d shareplan touch ``` ## Limits and tiers - free-- (registered / hosted): 7d default TTL, 30d max, unlisted, no vanity slugs - ops (self-hosted operator key): no TTL maximum cap, permanent hosting (ttl: null) and slugs allowed - Files: HTML, CSS, JS, JSON, text, markdown, images, fonts (up to 50 MiB, 200 files)