Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.athenahq.ai/llms.txt

Use this file to discover all available pages before exploring further.

This page documents all notable changes to the AthenaHQ API, including new features, improvements, and bug fixes. We recommend reviewing this changelog regularly to stay informed about updates that may affect your integration.

​
May 2026

​
New: Content Hub endpoints

You can now read Content Hub data — tracked URLs, citation/impression metrics, and per-URL prompt breakdowns — via the API. These power GEO reporting that includes both 1st-party (Athena-created) and 3rd-party (link-building placements, Reddit, partner posts) content in one place.
  • GET /api/v1/content/sheets — List the Content Hub tabs configured for a website. Call this first to discover the sheet_ids you can filter by.
  • POST /api/v1/content — Paginated tracked content with citations, citation %, estimated impressions, and total responses for the date range. Filter by sheet_id, content_type, mentioned, and the standard filter knobs.
  • POST /api/v1/content/prompts — For a single content item, the list of prompts whose AI responses cite it — with per-prompt citation counts and percentages. Works for both topic-attached and 3rd-party content without a topic assignment.

​
New: Saved views endpoint

You can now fetch saved views (filter presets) for a website via the API. Saved views capture a named set of dashboard filters that can be reused across the product.
  • GET /api/v1/saved-views — List saved views for a website. Returns each view’s filters, icon, and creator metadata.

​
New: Group saved views endpoint

You can now fetch group-level saved views via the API. Group saved views capture filter state shared across the websites in a group rather than scoped to a single website.

​
April 2026

​
Updated: Multi-country support on prompts

GET /api/v1/prompts now returns a countries array on each prompt, listing every country targeted by that prompt along with an is_primary flag. The primary country is listed first; remaining countries follow in alphabetical order.
  • countries: [{ country: string, is_primary: boolean }] — New field. Empty array when the prompt has no countries assigned.
  • country: string — Deprecated, but still populated for backward compatibility. Returns the primary country (or the alphabetically first, or "United States" as a final fallback). New integrations should read countries instead.

​
New: Delete and restore websites

You can now delete and restore websites via the API. Deleting removes a website from your organization and stops all associated processing; restoring brings it back exactly as it was, with all historical data preserved. This is the recommended flow for partner integrations that need to handle customer churn and reactivation.
  • POST /api/v1/websites/{website_id}/delete — Deletes a website.
  • POST /api/v1/websites/{website_id}/restore — Reactivates a deleted website.
Both endpoints require a global API key. Both are idempotent: re-calling them on a website that is already in the target state returns 200.

​
Updated: Invite users to groups

POST /api/v1/invites now accepts type: "group" with a group_id, granting the user access to every website in the group. POST /api/v1/invites/bulk accepts a new group_ids array (mutually exclusive with website_ids, max 50) for inviting a user to multiple groups in one request. Both branches behave consistently with the existing org/website invites: invite_method: "direct" adds the user immediately (creating a new user account automatically if the email has none) without sending any email, while invite_method: "email" creates a pending invite and sends an invitation. Group invites require a global API key. Users who are already members of the organization cannot be invited to individual groups — they already have cascade access to every group.

​
New: Team management endpoints

You can now manage team members and pending invites programmatically. These endpoints unblock automated user provisioning, role changes, and cleanup without touching the AthenaHQ dashboard. List members and access
  • GET /api/v1/organizations/members — Lists all members of your organization with their email, name, and role. Requires a global API key.
  • GET /api/v1/websites//members — Lists all users with access to a website, tagged with access_type (organization for implicit access via org membership, website for explicit website membership). Accepts a global or website-scoped API key.
  • GET /api/v1/users//websites — Lists the websites a specific user has access to within your organization. Requires a global API key.
Update and remove members Revoke pending invites Mutating endpoints include safety guards: you cannot modify the API key’s owning user, the organization owner, or the last remaining admin of an organization.

​
Updated: Direct invite responses now include user_id

POST /api/v1/invites and POST /api/v1/invites/bulk now return user_id in their success responses for invite_method: "direct" only. In direct mode, the user is looked up or created immediately, so returning the ID gives you everything you need to call the new member-management endpoints without a discovery round-trip. Email-method invites intentionally do not return user_id — doing so would let any API key holder enumerate account existence across tenants by email. This change is backward-compatible; existing integrations continue to work unchanged.

​
New: Provision Website endpoint (Beta)

You can now create a fully configured website in a single API call, skipping the onboarding wizard. Optionally set up competitors, prompts, and a processing schedule — all in one request. This endpoint is currently in beta — the request and response schemas may change.

​
New: Get group credits

You can now retrieve the current credit balance for a group, including the monthly and one-off breakdown.

​
March 2026

​
New: Get and update individual groups

You can now fetch a single group by ID and update it — rename the group, add websites, or remove websites. Both endpoints require a global API key.

​
New: Bulk invite to websites

You can now invite a user to multiple websites in a single API call. The endpoint processes each website independently and returns per-website results, making it easy to onboard users across your organization.

​
February 2026

​
New: Groups endpoints

You can now create and manage groups of websites via the API. Groups let you organize multiple websites under a single entity within your organization. Both endpoints require a global API key.