Share links

POST   /api/v1/share                         mint
GET    /api/v1/share?projectId=              list
DELETE /api/v1/share?projectId=&token=       revoke

curl -X POST "https://productbrain.com/api/v1/share" \
  -H "Authorization: Bearer pb_..." \
  -H "Content-Type: application/json" \
  -d '{ "projectId": "my-project", "expiresInDays": 30 }'

{
  "token": "h8EqUkVz2nX8hxAi4VlL-",
  "url": "https://productbrain.com/shared/h8EqUkVz2nX8hxAi4VlL-",
  "expiresAt": "2026-10-17T23:21:36.088Z",
  "_meta": { "_tip": "Expires 2026-10-17T23:21:36.088Z. List with GET /api/v1/share?projectId=…; revoke with DELETE …&token=…. Treat the token as a secret." }
}

curl -s "https://productbrain.com/api/v1/share?projectId=my-project" \
  -H "Authorization: Bearer pb_..."

{
  "tokens": [
    {
      "token": "h8EqUkVz2nX8hxAi4VlL-",
      "url": "https://productbrain.com/shared/h8EqUkVz2nX8hxAi4VlL-",
      "settings": {},
      "createdAt": "2026-09-17T23:21:36.142667+00:00",
      "expiresAt": "2026-10-17T23:21:36.088+00:00",
      "revokedAt": null,
      "active": true
    }
  ],
  "_meta": { "_tip": "Each token is a PUBLIC link. ..." }
}

curl -X DELETE "https://productbrain.com/api/v1/share?projectId=my-project&token=h8EqUkVz2nX8hxAi4VlL-" \
  -H "Authorization: Bearer pb_..."

{ "success": true, "revoked": "h8EqUkVz2nX8hxAi4VlL-", "_meta": { "_tip": "Link revoked. ... stops serving within ~30s (edge cache); the DB record is dead immediately." } }