Concepts

These pages explain how poolse works. The API reference and SDK reference give the exact calls; read the concept first when you want to know why.

If you read only one, read Authentication. Most integration bugs come from mixing up the API key and the user token.

All concepts

• Tenants & data model: workspaces, end-users, conversations, messages and what owns what.
• Authentication: the API key, the user token, scopes and rotation.
• Conversations & roles: direct and group conversations, members and roles.
• Messages: sending, editing, deleting, reactions, threads, mentions and attachments.
• Read receipts & unread: read state, unread counts and the workspace read-receipt setting.
• Realtime: the WebSocket connection, and what arrives over realtime, push and webhooks.
• Calls & rooms: voice and video calls, rooms and call limits.
• Push notifications: what poolse sends to phones and when.
• Webhooks: signed deliveries to your backend, retries and idempotency.
• Encryption & retention: what is encrypted, what is stored in plaintext and how long data is kept.
• Limits & quotas: plan quotas (402), abuse limits (429) and fixed limits on every plan.