Skip to main content

​
Base URL

https://api.aether.dev
If you are self-hosting Aether, replace this with your own deployment URL.

​
Request Format

All request and response bodies are JSON. Set the Content-Type header to application/json for requests with a body.

​
Authentication

Most endpoints require authentication. Include a Bearer token in the Authorization header: 
curl https://api.runaether.dev/projects \
  -H "Authorization: Bearer YOUR_TOKEN"
See Authentication for details on obtaining and refreshing tokens.

​
Error Responses

Errors return an appropriate HTTP status code with a JSON body: 
{
  "error": "Project not found"
}

​
Common Status Codes

CodeDescription
200Success
201Created
204No Content (successful deletion)
400Bad Request — invalid parameters
401Unauthorized — missing or invalid token
403Forbidden — insufficient permissions
404Not Found
409Conflict — resource already exists
429Too Many Requests — rate limit exceeded
500Internal Server Error

​
Rate Limiting

API requests are rate-limited per user. When you exceed the limit, the API returns a 429 status code. Respect the Retry-After header value before retrying.

​
Pagination

List endpoints return all results by default. For endpoints that support pagination, use limit and offset query parameters.