Revoke a device's push registration
Marks the caller's active registration for one installation revoked so it stops receiving push notifications, and reports whether a row was actually revoked. Naturally idempotent: a second call reports `revoked: false`. Requires a Clerk session with a synced profile.
Authorization
apiKey Workspace API key created in Workspace settings → API keys. Scopes on the key bound what it can read and write.
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
curl -X POST "https://example.com/v1/me/push-devices/revoke" \ -H "Content-Type: application/json" \ -d '{ "installationId": "7a1bf939-4d70-4439-9ced-a3dbbce12bd7" }'{ "data": { "installationId": "7a1bf939-4d70-4439-9ced-a3dbbce12bd7", "revoked": true }}{ "_tag": "ApiNotFound", "error": "not_found", "message": "That item does not exist, or this key cannot see it.", "status": 404}{ "_tag": "ApiNotFound", "error": "not_found", "message": "That item does not exist, or this key cannot see it.", "status": 404}Register a device for push notifications
Stores the caller's Expo push token for an installation and activates it, first revoking any other active row holding the same installation id or token so a device can move between accounts. Naturally idempotent: re-registering the same installation refreshes the existing row rather than adding one. Requires a Clerk session with a synced profile, and the token must be a well-formed Expo push token.
List an item's share links
Returns the share links minted for one item with their expiry, use count and cap, download allowance, and revocation state. The token is never returned: listed URLs carry only the bare public path. Requires view access on the item.