API Documentation
The Mewk API lets you interact with Mewk programmatically. All endpoints are under /api/v1.
Base URL
https://mewk.app/api/v1
Versioning
The current API version is v1. The version is included in the URL path (/api/v1/...). Future versions will be introduced with a new path prefix.
Rate Limits
API requests are rate-limited per key. Exceeding the limit returns HTTP 429.
| Request type | Limit |
|---|---|
| Read endpoints (GET) | 60 / min |
| Write endpoints (POST/PUT/DELETE) | 30 / min |
Error Format
Errors are returned as JSON with a statusCode and message field.
{
"statusCode": 401,
"message": "Unauthorized"
}Sections
Authentication
API keys: creating and using them
Questions
Send, retrieve, answer, and delete questions
Card Layouts
Create, share, and import card layouts
Discovery
Discover/Explore/Trending endpoints and scoring logic
Users
User profile and stats
Achievements
Achievement retrieval and pinning
Settings
Read and update account settings
Webhooks
Webhook CRUD and test delivery