API Overview

The Blueth API provides programmatic access to plugins, servers, and user data.

Base URL

https://blueth.online/api

Response Format

All API responses are returned as JSON. Successful responses return the requested data directly. Error responses include an error field with a human-readable message.

Success Response

{
  "id": "abc123",
  "name": "Example Plugin",
  ...
}

Error Response

{
  "error": "Not found"
}

Authentication

Most read endpoints are public and do not require authentication. Write endpoints (creating servers, updating profiles) require session authentication via cookies.

Rate Limits

Currently there are no strict rate limits. Please be respectful with your API usage. Excessive requests may result in temporary blocks.

Available Endpoints