Aetherion AI
Operating Workspace
Read the workspace.Connect what comes next.
Bring Aetherion project data into your own dashboards, portals, reports and developer workflows. Version 1 exposes a secure, deliberately read-only contract.
GET /api/v1/projects
Authorization: Bearer aeth_live_••••
{
"ok": true,
"request_id": "req_…",
"data": { "projects": […] }
}One API · Two operation classes
Read is available now.Actions remain isolated.
Read operations are useful without risking project state. Write and action endpoints will arrive later as a separate permission layer, once the complete generator contract is stable.
Available
Read API
Inspect projects, source files, assets, deployments, snapshots, events, publication status, usage and AI generation history.
Later
Write & Actions
Project creation, file changes, agent runs, asset generation, publishing, rollback, domains, webhooks and automations.
Current keys contain only the read:workspace scope. Write access cannot appear silently on an existing key.
Workspace inventory
Read projects, status, versions and the operational shape of your Aetherion workspace.
Code and assets
Inspect safe project files and retrieve time-limited asset URLs without exposing environment secrets.
Release visibility
Follow deployments, snapshots, publication state, custom domains and live project URLs.
Usage reporting
Bring credits, plan limits and generation history into internal dashboards and reporting systems.
Twelve useful reads.One predictable contract.
Every endpoint requires a valid Aetherion API key, an active paid subscription and ownership of the requested project.
Hashed API key
The complete key is shown once and never stored in recoverable form.
Paid plan required
Registration alone does not enable API access.
Owner-scoped data
A key can only read records that belong to its account.
Durable rate limit
Every request is counted and returns limit headers.
/api/v1/meAccount and API access/api/v1/projectsProjects/api/v1/projects/{id}Project details/api/v1/projects/{id}/filesFile tree/api/v1/projects/{id}/files/contentFile content/api/v1/projects/{id}/assetsAssets/api/v1/projects/{id}/deploymentsDeployments/api/v1/projects/{id}/eventsEvents/api/v1/projects/{id}/snapshotsSnapshots/api/v1/projects/{id}/publicationPublication/api/v1/usageUsage and limits/api/v1/generationsGeneration historyCreate a key.Keep the workspace in view.
Sign in, activate a paid plan and generate a read-only key from Account Center. The complete key is shown only once.