# Clody

## Docs

- [Clody Platform Overview: Core Concepts and How It Works](https://apidocs.clody.lol/introduction.md): Clody is a real-time messaging platform with Branches for private chats, Picnics for community channels, voice calls, reactions, and GIF support.
- [Clody Quickstart: Register, Log In, and Send a Message](https://apidocs.clody.lol/quickstart.md): Step-by-step guide to creating a Clody account, completing two-step login with email verification, and sending your first message in minutes.
- [Clody Authentication: Sessions, Login, and Verification](https://apidocs.clody.lol/authentication.md): Clody uses HTTP session cookies for authentication. Learn how to register, log in with email verification codes, manage sessions, and log out.
- [Branches: Private Messaging and Group Chats in Clody](https://apidocs.clody.lol/concepts/branches.md): Branches are Clody's private messaging spaces. Direct messages and group chats, limited to friends, with real-time updates and file attachments.
- [Picnics: Public Community Broadcast Channels in Clody](https://apidocs.clody.lol/concepts/picnics.md): Picnics are Clody's public channels where admins post and members comment anonymously. Learn about roles, moderation, real-time events, and custom links.
- [Real-Time Events and Socket.IO Connection in Clody](https://apidocs.clody.lol/concepts/realtime.md): Connect to Clody's Socket.IO namespaces for live updates. Learn the session handshake and every event for messages, reactions, calls, and friends.
- [Send, Edit, and Reply to Messages in Clody Branches](https://apidocs.clody.lol/guides/messaging.md): Learn how to send, edit, delete, and reply to messages in Clody Branches, with support for file attachments and real-time delivery via Socket.IO.
- [Start, Join, and Manage Voice Calls in Clody Branches](https://apidocs.clody.lol/guides/voice-calls.md): Clody supports real-time voice calls within Branches. Learn how to start, join, manage mic, share your screen, and end calls using Socket.IO.
- [How to Upload Branch Files, GIFs, and Avatars in Clody](https://apidocs.clody.lol/guides/media-uploads.md): Learn how to upload files, avatars, and GIFs in Clody. Covers Branch attachments, Picnic files, user avatars, and size limits for each upload type.
- [How to Manage Friends, Requests, and Blocks in Clody](https://apidocs.clody.lol/guides/friends.md): Learn how to send friend requests, accept or decline them, remove friends, and block users in Clody. Friend connections are required to create Branches.
- [How to Create and Use Bots in Clody](https://apidocs.clody.lol/guides/bots.md): Learn how to create bots in Clody, authenticate as a bot with a token, edit bot profiles, and use bots to send messages and act on behalf of automation.
- [Clody Authentication API: Register, Login, and Sessions](https://apidocs.clody.lol/api/auth.md): Complete reference for Clody authentication endpoints. Register, log in via email code, verify email, check session state, and log out.
- [Users API: Look Up Clody User Profiles by Username or ID](https://apidocs.clody.lol/api/users.md): Look up any Clody user by username or numeric ID. Returns their full profile including display name, avatar, online status, and relationship info.
- [Settings API: Manage Your Clody Profile and Preferences](https://apidocs.clody.lol/api/settings.md): Read and update your Clody profile settings including display name, avatar, bio, accent color, status text, and privacy preferences.
- [Branches API: Group and Direct Message Conversations](https://apidocs.clody.lol/api/branches.md): API reference for Clody Branches — private chats and group conversations. Create, rename, add/remove members, and retrieve branch details.
- [Branch Messages API: Send and Manage Chat Messages](https://apidocs.clody.lol/api/branch-messages.md): API reference for sending, listing, editing, deleting, and marking as read messages in Clody Branches. Supports replies, file attachments, and pagination.
- [Picnics API: Create and Manage Clody Community Channels](https://apidocs.clody.lol/api/picnics.md): API reference for Clody Picnics — community channels with owner, admin, and member roles. Create, search, join, edit, moderate, and delete picnics.
- [Picnic Messages API: Post and Manage Channel Content](https://apidocs.clody.lol/api/picnic-messages.md): API reference for Clody Picnic posts. Admins create, edit, and delete posts; members view them. Supports file attachments, pinning, and read tracking.
- [Comments API: Threaded Replies on Clody Picnic Posts](https://apidocs.clody.lol/api/comments.md): API reference for Clody Picnic comments. Members leave threaded replies on posts, like comments, and edit or delete their own contributions.
- [Clody Reactions API: Add Emoji Reactions to Messages](https://apidocs.clody.lol/api/reactions.md): API reference for Clody emoji reactions on Branch messages and Picnic posts. Add, list, and remove reactions with real-time Socket.IO updates.
- [GIFs API: Search and Attach Animated GIFs in Clody](https://apidocs.clody.lol/api/gifs.md): Search Giphy for animated GIFs to attach in Clody Branch messages. Returns preview and full URLs ready for use with the CDN attachment endpoint.
- [Clody CDN API: Upload and Retrieve Files in Branches](https://apidocs.clody.lol/api/cdn.md): Upload files, avatars, and GIFs to Clody CDN for use in Branch messages and Picnic posts. Returns filenames to include in message cdn arrays.
- [Voice Calls API: Real-Time Audio in Clody Branches](https://apidocs.clody.lol/api/voice-calls.md): API reference for Clody voice calls. Covers REST endpoints for tokens and servers, and Socket.IO events for starting, joining, and managing calls.
- [WebSocket Events Reference for Clody Real-Time API](https://apidocs.clody.lol/api/websocket-events.md): Complete reference for all Clody Socket.IO events across the main and /bcalls namespaces, including connection, messages, reactions, calls, and presence.
- [Clody Bots API: Create, Manage, and Authenticate Bots](https://apidocs.clody.lol/api/bots.md): API reference for managing Clody bots — create, edit, delete, list, and regenerate tokens. Includes the Authorization header format used to authenticate as a bot on any endpoint.