Reference5 min~137 words
API overview
Base URL, access requirements, scope and the read-only contract.
Read-only workspace contract
Aetherion API v1 lets an external server read safe data from the API key owner's workspace. It does not create projects, write files, run Builder, publish, deploy, change domains or delete data.
| Property | Value |
|---|---|
| Base URL | https://aetherionai.org/api/v1 |
| Authentication | Bearer API key |
| Required account | Registered user with an active paid plan |
| Scope | read:workspace |
| Rate limit | 120 requests per minute per key |
| Response format | JSON |
Make the first request
cURL
curl "https://aetherionai.org/api/v1/me" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Accept: application/json"JavaScript
const response = await fetch("https://aetherionai.org/api/v1/me", {
headers: {
Authorization: `Bearer ${process.env.AETHERION_API_KEY}`,
Accept: "application/json",
},
});
const body = await response.json();
if (!response.ok) throw new Error(body.error?.message || "API request failed");
console.log(body.data);Server-side use only
Do not place an Aetherion API key in browser code, a public repository, a generated frontend bundle or a shared screenshot.
Need project-specific help?
Open the private Help Center or create a support ticket with the affected project, route and request ID.