# MUDBASE

> Official MUDBASE documentation: REST API reference, OpenAPI spec, SDKs for JavaScript, Python, Go, Ruby, Java, C#, PHP, and Swift, plus authentication, realtime (Socket.IO), and webhooks.

## Getting Started
- [Introduction](https://docs.mudbase.dev/docs)
- [Authentication overview](https://docs.mudbase.dev/docs/authentication)
- [Changelog](https://docs.mudbase.dev/docs/changelog)
- [Error Handling](https://docs.mudbase.dev/docs/errors)
- [Quickstart](https://docs.mudbase.dev/docs/quickstart)

## Concepts
- [API Keys](https://docs.mudbase.dev/docs/concepts/api-keys)
- [Authentication](https://docs.mudbase.dev/docs/concepts/authentication)
- [Error Explorer](https://docs.mudbase.dev/docs/concepts/errors)
- [Projects](https://docs.mudbase.dev/docs/concepts/projects)
- [Rate Limits](https://docs.mudbase.dev/docs/concepts/rate-limits)
- [Request Lifecycle](https://docs.mudbase.dev/docs/concepts/request-lifecycle)
- [Webhooks](https://docs.mudbase.dev/docs/concepts/webhooks)

## Guides
- [Background Jobs](https://docs.mudbase.dev/docs/guides/background-jobs)
- [Chat (API & realtime)](https://docs.mudbase.dev/docs/guides/chat)
- [Error Handling](https://docs.mudbase.dev/docs/guides/error-handling)
- [Files & storage](https://docs.mudbase.dev/docs/guides/file-storage)
- [Roles & feature permissions](https://docs.mudbase.dev/docs/guides/multi-role)
- [Pagination](https://docs.mudbase.dev/docs/guides/pagination)
- [Realtime Events](https://docs.mudbase.dev/docs/guides/realtime-events)
- [User Authentication](https://docs.mudbase.dev/docs/guides/user-authentication)
- [Handling Webhooks](https://docs.mudbase.dev/docs/guides/webhooks)

## SDKs
- [SDKs Overview](https://docs.mudbase.dev/docs/sdks)
- [C# SDK](https://docs.mudbase.dev/docs/sdks/csharp)
- [Go SDK](https://docs.mudbase.dev/docs/sdks/go)
- [Java SDK](https://docs.mudbase.dev/docs/sdks/java)
- [PHP SDK](https://docs.mudbase.dev/docs/sdks/php)
- [Python SDK](https://docs.mudbase.dev/docs/sdks/python)
- [Ruby SDK](https://docs.mudbase.dev/docs/sdks/ruby)
- [Swift SDK](https://docs.mudbase.dev/docs/sdks/swift)
- [TypeScript SDK](https://docs.mudbase.dev/docs/sdks/typescript)

## Realtime
- [Server-Sent Events](https://docs.mudbase.dev/docs/realtime/events)
- [Socket.IO overview](https://docs.mudbase.dev/docs/realtime/websockets)
- [Socket.IO: Auth events](https://docs.mudbase.dev/docs/realtime/websockets/auth-socket)
- [Socket.IO: Calls](https://docs.mudbase.dev/docs/realtime/websockets/calls)
- [Socket.IO: Chat](https://docs.mudbase.dev/docs/realtime/websockets/chat-messaging)
- [Socket.IO: Client emits](https://docs.mudbase.dev/docs/realtime/websockets/client-emits)
- [Socket.IO: Connection](https://docs.mudbase.dev/docs/realtime/websockets/connection)
- [Socket.IO: Custom channels](https://docs.mudbase.dev/docs/realtime/websockets/custom-channels)
- [Socket.IO: Dashboard recipes](https://docs.mudbase.dev/docs/realtime/websockets/dashboard)
- [Socket.IO: Database](https://docs.mudbase.dev/docs/realtime/websockets/database)
- [Socket.IO: Errors & limits](https://docs.mudbase.dev/docs/realtime/websockets/errors-limits)
- [Socket.IO: Integrations](https://docs.mudbase.dev/docs/realtime/websockets/integrations)
- [Socket.IO: Org & project](https://docs.mudbase.dev/docs/realtime/websockets/org-project)
- [Socket.IO: Presence](https://docs.mudbase.dev/docs/realtime/websockets/presence)
- [Socket.IO: Rooms](https://docs.mudbase.dev/docs/realtime/websockets/rooms)
- [Socket.IO: Server events](https://docs.mudbase.dev/docs/realtime/websockets/server-events)
- [Socket.IO: Wallets](https://docs.mudbase.dev/docs/realtime/websockets/wallets)

## 400 · Validation failed
- [VALIDATION_ERROR](https://docs.mudbase.dev/docs/concepts/errors#err-VALIDATION_ERROR)

## 401 · Authentication required
- [UNAUTHORIZED](https://docs.mudbase.dev/docs/concepts/errors#err-UNAUTHORIZED)

## 403 · Access denied
- [FORBIDDEN](https://docs.mudbase.dev/docs/concepts/errors#err-FORBIDDEN)

## 403 · Creating organizations via API is disabled.
- [ORG_CREATION_DISABLED](https://docs.mudbase.dev/docs/concepts/errors#err-ORG_CREATION_DISABLED)

## 403 · Please verify your email to sign in. Check your inbox for the verification link.
- [EMAIL_VERIFICATION_REQUIRED](https://docs.mudbase.dev/docs/concepts/errors#err-EMAIL_VERIFICATION_REQUIRED)

## 404 · Resource not found
- [NOT_FOUND](https://docs.mudbase.dev/docs/concepts/errors#err-NOT_FOUND)

## 409 · Resource already exists
- [CONFLICT](https://docs.mudbase.dev/docs/concepts/errors#err-CONFLICT)

## 429 · Rate limit exceeded
- [RATE_LIMITED](https://docs.mudbase.dev/docs/concepts/errors#err-RATE_LIMITED)

## 500 · Internal server error
- [INTERNAL_ERROR](https://docs.mudbase.dev/docs/concepts/errors#err-INTERNAL_ERROR)

## 503 · Service temporarily unavailable. Please try again later.
- [SERVICE_UNAVAILABLE](https://docs.mudbase.dev/docs/concepts/errors#err-SERVICE_UNAVAILABLE)

## Tools
- [API Playground](https://docs.mudbase.dev/docs/api/playground)
- [Add-ons](https://docs.mudbase.dev/docs/tools/addons)
- [Live API Logs](https://docs.mudbase.dev/docs/tools/api-logs)
- [Socket.IO connection test](https://docs.mudbase.dev/docs/tools/websocket-tester)

## API Reference
- [API Reference Overview](https://docs.mudbase.dev/docs/api): Base URL, authentication, rate limits, pagination, errors, and the full endpoint catalog
- [OpenAPI specification](https://docs.mudbase.dev/openapi.yaml): Machine-readable spec for every endpoint - the source of truth the ~340 individual reference pages are generated from

## AI Agents
- [Mudbase Claude Skill](https://github.com/themudhaxk/mudbase-skill): Complete, fact-checked SKILL.md covering auth, collections, storage, realtime, functions, webhooks, MCP, add-ons, KYC, payment links, and wallet broadcasting - clone into ~/.claude/skills/mudbase, or read the raw file directly if you're not Claude Code