Back to Base

Developer Interface

Endpoints for the bawkKA anonymity protocol.

Session Authentication

This protocol uses secure HTTP-only Session Cookies. Endpoints are accessible only when a valid user session is active.

Cookie: next-auth.session-token=[your_active_session]

Protocol Endpoints

POST/api/accept-messages

Toggle whether your profile is currently accepting new whispers.

POST/api/auth/change-password

Update the account password while the user is logged in.

DELETE/api/auth/delete-account

Permanently terminate account and wipe all associated protocol data.

POST/api/auth/forgot-password

Trigger a password recovery email for a specific account.

POST/api/auth/reset-password

Finalize password reset using a secure recovery token.

DELETE/api/delete-all-messages

Wipe your entire whisper history. This action is irreversible.

DELETE/api/delete-message

Permanently remove a specific whisper from your inbox.

GET/api/get-messages

Retrieve the list of whispers received by the authenticated user.

POST/api/send-message

Deliver an anonymous whisper to a specific user profile.

POST/api/sign-up

Initialize a new user account on the bawkKA protocol.

GET/api/suggest-messages

Fetch AI-generated conversation starters for anonymous prompts.

GET/api/username-unique

Check real-time availability of a username during registration.

GET/api/verify-code

Verify the OTP or magic link code sent for authentication.

Rate Limit: 100 req/min
AUTH: [...nextauth]