Account, catalog and inspect

GET /v1/account

operationId getAccount. Accepts an API key, an OAuth token or a dashboard session. Response AccountResponse:

{
  "plan": { "id": "free", "name": "Free" },
  "status": "free" | "active" | "past_due" | "canceled",
  "cadence": "monthly" | "annual" | null,
  "credits": { "used": 12, "cap": 500, "period_end": "2026-10-19T17:35:40.303Z" | null },
  "sharpen_tier": "sharpen" | "plus" | "ultra" | "ultra2x",
  "sharpen_stage"?: "stock" | "stage1" | "stage2" | "stage3" | "stage3+",
  "enabled_capabilities": [ "academic.search", "…", "sharpen" ]
}

curl -s https://api.powerups-ai.store/v1/account -H "Authorization: Bearer $AIPA_API_KEY"

GET /v1/catalog

operationId getCatalog. Response CatalogResponse: every capability with enabled (switched on for this account), available (the vendor key exists in this deployment; false comes with unavailable_reason), typical_credits and inspect_url, plus the Sharpen entitlement and orientation text for agents.

{
  "capabilities": [ { "id": "hotels.search", "title": "Hotels", "summary": "…", "topic": "hotels",
                      "enabled": true, "available": true, "typical_credits": 4,
                      "inspect_url": "https://api.powerups-ai.store/v1/capabilities/hotels.search" }, … ],
  "sharpen": { "tier": "sharpen", "stage": "stock", "stages": [ … ], "url": "…", "typical_credits": 5, "enabled": false },
  "instructions": "…"
}

Use it at deploy time to confirm availability of the capabilities you depend on. It is the only place that knows a deployment's vendor keys; the reference pages cannot.

GET /v1/capabilities/{id}

operationId inspectCapability. Response CapabilityInspectResponse: execute.body_schema (the same JSON Schema as the request component in the public OpenAPI document), follow_ups[] with scope and optional params_schema, worked examples[] and cost. Built for agents that discover shapes at runtime; a deterministic application should generate its types from the OpenAPI document at build time instead and never needs this call.

Public documents

• GET /v1/openapi.public.json: the developer document, no auth, not rate limited.
• GET /v1/guide (operationId getGuide): the Markdown guide served to agents, text/markdown.
• GET /health/live and GET /health/ready: { status, checks, version }; ready is 503 when the database probe fails.