mocop
Browse · Docs · Guide · Analyze

Aetherya API

API by Aetherya · rest

Hand-written specification covering Aetherya's agent-facing HTTP surface: decision studies (autopilot), usage and estimation, cognitive audits, audiences and Audience Chat. It is maintained alongside the API rather than generated from it, so treat an endpoint that behaves differently from this document as a bug in the document and tell us. Authentication is a bearer API key (prefix aeth_live_), created by a signed-in person at https://app.aetherya.ai/dashboard/settings?tab=api-keys. Send Authorization: Bearer aeth_live_.... Personal keys allow 60 requests a minute; organization keys follow the organization's plan. Requests act inside one workspace. Without an X-Aetherya-Workspace-Id header the key's default workspace is used; sending the header targets another workspace the key's owner belongs to. Recommended flow for an agent: POST /api/research-lab/autopilot with a plain-English objective, poll it, confirm the quoted price with POST .../confirm, then read the brief.

Endpoint: https://api.aetherya.ai/

Verification: observed. Source: crawl.

Capabilities (16)

  • Send a message to a simulated audience chat session
  • Create an audience chat session
  • Poll the status of an audit job
  • Start a behavioral-simulation audit of a URL
  • Fetch a completed audit report
  • List simulated audiences
  • Generate a simulated audience
  • Get approved API-equivalent usage values
  • Get canonical pricing tiers
  • Design price and run a study from a plain-English objective
  • Poll an autopilot run
  • Answer a clarifying question
  • Cancel a run
  • Accept the quoted price and launch
  • Estimate a workload as a percentage range
  • Get percentage-based usage status
About · Contact · Privacy