List Activity

curl --request GET \
  --url https://api.athenahq.ai/api/v1/activity \
  --header 'x-api-key: <api-key>'

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://api.athenahq.ai/api/v1/activity', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.athenahq.ai/api/v1/activity",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.athenahq.ai/api/v1/activity"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.athenahq.ai/api/v1/activity")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "activity": [
    {
      "id": "6f1c2a3e-5b7d-4e8f-9a0b-1c2d3e4f5a6b",
      "occurred_at": "2026-09-20T08:14:03.512Z",
      "website_id": "3b9d1e2f-4a5b-4c6d-8e7f-9a0b1c2d3e4f",
      "entity_type": "prompt",
      "change_type": "created",
      "entity_ids": [
        "a1f0b2c3-d4e5-4f60-8172-839405a6b7c8"
      ],
      "actor": {
        "type": "user",
        "api_key_id": null,
        "api_key_name": null
      }
    },
    {
      "id": "7a44b5c6-d7e8-4f90-a1b2-c3d4e5f6a7b8",
      "occurred_at": "2026-09-20T08:15:41.007Z",
      "website_id": "3b9d1e2f-4a5b-4c6d-8e7f-9a0b1c2d3e4f",
      "entity_type": "prompt",
      "change_type": "deleted",
      "entity_ids": [
        "c2d1e3f4-a5b6-4c7d-8e9f-0a1b2c3d4e5f",
        "c2d2e3f4-a5b6-4c7d-8e9f-0a1b2c3d4e5f"
      ],
      "actor": {
        "type": "user",
        "api_key_id": null,
        "api_key_name": null
      }
    },
    {
      "id": "8b90c1d2-e3f4-4a5b-9c6d-7e8f9a0b1c2d",
      "occurred_at": "2026-09-20T09:02:10.220Z",
      "website_id": "9e07f1a2-b3c4-4d5e-8f60-718293a4b5c6",
      "entity_type": "topic",
      "change_type": "updated",
      "entity_ids": [
        "d5510000-0000-4000-8000-000000000001"
      ],
      "actor": {
        "type": "user",
        "api_key_id": null,
        "api_key_name": null
      }
    },
    {
      "id": "9c12d3e4-f5a6-4b7c-8d9e-0f1a2b3c4d5e",
      "occurred_at": "2026-09-20T11:30:00.918Z",
      "website_id": "9e07f1a2-b3c4-4d5e-8f60-718293a4b5c6",
      "entity_type": "prompt",
      "change_type": "updated",
      "entity_ids": null,
      "actor": {
        "type": "api_key",
        "api_key_id": "a8f20000-0000-4000-8000-000000000002",
        "api_key_name": "Production integration"
      }
    }
  ],
  "pagination": {
    "page_num": 0,
    "page_size": 100,
    "has_more": true
  }
}

Activity

List Activity

Returns the changes made to prompts, topics and prompt tags across your organization, newest first by default. Each entry names the website, the entity type, the kind of change (created, updated, deleted, restored, paused, unpaused), the affected entity ids and who made the change. Use it to find out what happened without re-listing every website.

entity_ids is null when the affected set is not known (for example a bulk import); re-list that website’s prompts with GET /api/v1/prompts. A topic or prompt_tag entry means the topic_name or tags of that website’s prompts may have changed, so re-list the website in that case too. Changes made with an API key carry the key’s id and name in actor, so you can skip your own writes. User emails are never returned. Websites provisioned through POST /api/v1/websites/provision do not appear here; list a website once after provisioning it.

To mirror data, pin a window per sync run: set since to the previous run’s until, set until to now minus one minute, pass order=asc, walk page_num until pagination.has_more is false, then store that until for the next run. since is exclusive and until inclusive, so consecutive windows neither overlap nor skip. With no since the walk covers the whole history, so order=asc with no bounds is a full export. Pagination uses page_size + 1 lookahead: there is no total-count field.

Requires a partner API key. Keys scoped to specific websites see only those websites.

GET

api

activity

List Activity

curl --request GET \
  --url https://api.athenahq.ai/api/v1/activity \
  --header 'x-api-key: <api-key>'

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://api.athenahq.ai/api/v1/activity', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.athenahq.ai/api/v1/activity",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.athenahq.ai/api/v1/activity"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.athenahq.ai/api/v1/activity")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "activity": [
    {
      "id": "6f1c2a3e-5b7d-4e8f-9a0b-1c2d3e4f5a6b",
      "occurred_at": "2026-09-20T08:14:03.512Z",
      "website_id": "3b9d1e2f-4a5b-4c6d-8e7f-9a0b1c2d3e4f",
      "entity_type": "prompt",
      "change_type": "created",
      "entity_ids": [
        "a1f0b2c3-d4e5-4f60-8172-839405a6b7c8"
      ],
      "actor": {
        "type": "user",
        "api_key_id": null,
        "api_key_name": null
      }
    },
    {
      "id": "7a44b5c6-d7e8-4f90-a1b2-c3d4e5f6a7b8",
      "occurred_at": "2026-09-20T08:15:41.007Z",
      "website_id": "3b9d1e2f-4a5b-4c6d-8e7f-9a0b1c2d3e4f",
      "entity_type": "prompt",
      "change_type": "deleted",
      "entity_ids": [
        "c2d1e3f4-a5b6-4c7d-8e9f-0a1b2c3d4e5f",
        "c2d2e3f4-a5b6-4c7d-8e9f-0a1b2c3d4e5f"
      ],
      "actor": {
        "type": "user",
        "api_key_id": null,
        "api_key_name": null
      }
    },
    {
      "id": "8b90c1d2-e3f4-4a5b-9c6d-7e8f9a0b1c2d",
      "occurred_at": "2026-09-20T09:02:10.220Z",
      "website_id": "9e07f1a2-b3c4-4d5e-8f60-718293a4b5c6",
      "entity_type": "topic",
      "change_type": "updated",
      "entity_ids": [
        "d5510000-0000-4000-8000-000000000001"
      ],
      "actor": {
        "type": "user",
        "api_key_id": null,
        "api_key_name": null
      }
    },
    {
      "id": "9c12d3e4-f5a6-4b7c-8d9e-0f1a2b3c4d5e",
      "occurred_at": "2026-09-20T11:30:00.918Z",
      "website_id": "9e07f1a2-b3c4-4d5e-8f60-718293a4b5c6",
      "entity_type": "prompt",
      "change_type": "updated",
      "entity_ids": null,
      "actor": {
        "type": "api_key",
        "api_key_id": "a8f20000-0000-4000-8000-000000000002",
        "api_key_name": "Production integration"
      }
    }
  ],
  "pagination": {
    "page_num": 0,
    "page_size": 100,
    "has_more": true
  }
}

Authorizations

x-api-key

string

header

required

API key for authentication. You can create one here.

Query Parameters

since

string<date-time>

ISO 8601 timestamp. Only changes strictly after this instant. Omit to start from the beginning of the organization's history.

until

string<date-time>

ISO 8601 timestamp. Only changes up to and including this instant. Pin it per sync run so pages cannot shift while you page.

order

enum<string>

default:desc

desc (default) lists the newest changes first. Use asc to export or sync in the order the changes happened.

Available options:

desc,

asc

website_id

string<uuid>

Restrict to one website. Omit for the whole organization. A website outside your key's scope, or outside your organization, returns 403.

entity_type

enum<string>[]

Comma-separated list of entity types to include. Omit for all.

Available options:

prompt,

topic,

prompt_tag

change_type

enum<string>[]

Comma-separated list of change types to include. Omit for all.

Available options:

created,

updated,

deleted,

restored,

paused,

unpaused

page_num

integer

default:0

Zero-indexed page number.

Required range: x >= 0

page_size

integer

default:100

Number of entries per page (1-100).

Required range: 1 <= x <= 100

Response

Successful response with the page of changes.

activity

object[]

required

Show child attributes

pagination

object

required

Pagination metadata. Uses page_size + 1 lookahead — has_more=true means the next page is non-empty. No total-count field, by design (avoids the extra COUNT(*) round-trip).

Show child attributes

Overview

Integrations

Core Resources

Analytics

Content & Knowledge

Administration

List Activity

Authorizations

Query Parameters

Response