Profile
V2: Shareable, anonymous-first address handles ("@kofi") — a private alternative to a formal address that the owner can update whenever they move
Create a shareable address handle
Creates a publicly readable, shareable '@handle' pointing at a location —
Check handle availability
Check handle availability
Get an address profile
Public profiles require no credential. Private profiles require either
Update an address profile (e.g. after moving)
Requires the `X-Edit-Token` header issued at creation. The primary
Delete an address profile
Requires the `X-Edit-Token` header issued at creation.
Create an expiring read-only link for a private profile
Requires owner edit token and private visibility. Up to ten active links
List active guest-link metadata without tokens or URLs
Owner-only. Expired, revoked and invalidated grants are excluded. Responses use no-store.
Revoke one guest link
Owner-only; revocation prevents subsequent authorization with this token.
Social preview for public profiles only
Private profiles are withheld even with owner/guest credentials. Responses use no-store.
Social map image for public profiles only
Private profiles are withheld even with owner/guest credentials. Responses use no-store.
Enable recovery or replace the saved code
Requires the current owner edit token. Returns a new 256-bit secret;
Revoke the saved recovery code
Requires the current owner edit token. Clears recovery and retry state
Restore editing access using a saved recovery code
No edit token or API key is required; the saved recovery code proves
List named entrances and their delivery instructions
Owner-supplied coordinates/instructions, not independently verified.
Create or update a named entrance
Requires the profile owner's edit token. At most one entrance of each
Delete a named entrance
Delete a named entrance