Skip to Content

REST API Reference

elizaOS Cloud provides a comprehensive REST API for all platform features.

Stable

Looking for a full, route-by-route explorer? Go to API Explorer →

Base URL

https://cloud.milady.ai/api/v1

Authentication

All API requests require authentication via API key or session token:

curl -X GET "https://cloud.milady.ai/api/v1/dashboard" \ -H "Authorization: Bearer YOUR_API_KEY"

Get your API key from Dashboard → API Keys

Authentication Methods

MethodHeaderUse Case
API KeyAuthorization: Bearer ek_xxxServer-to-server
X-API-KeyX-API-Key: ek_xxxAlternative header
SessionCookie-basedBrowser applications

API Categories

Error Handling

All errors follow a consistent format:

{ "error": { "code": "INVALID_REQUEST", "message": "The request body is invalid", "details": "Field 'model' is required" } }

Error Codes

CodeHTTP StatusDescription
UNAUTHORIZED401Invalid or missing authentication
FORBIDDEN403Insufficient permissions
NOT_FOUND404Resource not found
RATE_LIMITED429Too many requests
INSUFFICIENT_CREDITS402Not enough credits
INTERNAL_ERROR500Server error

Rate Limits

EndpointRate Limit
Chat completions60 req/min
Embeddings100 req/min
Image generation20 req/min
Video generation5 req/min

Rate limits can be increased for enterprise plans. Contact sales for details.

OpenAPI Specification

The full OpenAPI specification is available at:

https://cloud.milady.ai/api/openapi.json

You can use this with tools like Swagger UI, Postman, or to generate client SDKs.