Create an expiring read-only link for a private profile
POST/v2/profile/:slug/shares
Requires owner edit token and private visibility. Up to ten active links per profile. Only a hash of the random 256-bit token is stored. Returned fragment URLs require frontend fragment handling and X-Share-Token propagation; they are not a new API query-string authentication method. Issuance is not idempotent. If the response is lost, list and revoke the unwanted link before issuing another. Responses use no-store. All links are invalidated by visibility changes, ownership recovery, or profile deletion. Tokens never grant editing or owner-only fields.
Request
Responses
- 201
- 400
- 401
- 404
- 409
- 429
- 500
Link issued; save token/URL now (not readable later)
SHARE_INVALID for invalid duration/label; INVALID_BODY for malformed, oversized or extra JSON (2 KiB maximum)
Missing edit token (MISSING_TOKEN)
Profile missing or wrong owner token (NOT_FOUND)
SHARE_LIMIT (ten active links) or PROFILE_NOT_PRIVATE
Five-request per-instance concurrency limit reached
Storage failure (INTERNAL)