List agent activity
API v2 is in public beta: endpoints and fields can change before general availability. See the changelog
/account/agent_activityCosts 1 rate-limit point · Rate limits
The writes agents made to this store, newest first: which client (Claude, ChatGPT, Quinn, an API key), when, which action and path, the target object, whether it succeeded, and the records it changed with a before/after of their fields. Filter by client, surface (api, mcp, quinn), status, target (target_type + target_id) or time (since/until, ISO 8601).
The log is being turned on store by store; until it is on for a store, nothing is recorded and the list is empty. A failed write changed nothing, so it has no changes. Each change names every changed field in fields, and keeps before/after values only for the fields the log shows for that kind of record, never credentials or customer contact details. Changes are recorded for offers, offer options, enrolled products, variants, settings, templates and theme integrations, when the action writes them itself; work it hands to a background job is not. Other writes (signups, customers, batches, feature flags, bulk adds, count resets) and changes made only in Shopify are listed as the action and target alone.
Also searched asagent activityactivity logwhat did you changechange historyaudit logrecent changeschanged by claude
Query parameters
clientstringOnly writes by this client, as entries name it (e.g. Claude, ChatGPT, Quinn, API key).
surfacestringOnly writes made through this surface, the REST API (api), MCP (mcp) or Quinn (quinn).
One ofapimcpquinnstatusstringOnly writes with this outcome.
One ofsucceededfailederrortarget_typestringOnly writes to this kind of resource, as entries name it (e.g. preorders/offers). Use with target_id.
sincestringOnly writes at or after this time, ISO 8601 (e.g. 2026-11-01T00:00:00Z).
untilstringOnly writes at or before this time, ISO 8601.
target_idstringOnly writes to the resource with this id, with target_type.
pageintegerPage of results, from 1.
Default1per_pageintegerEntries per page, at most 100.
Default25
Returns
entriesarray of objectsShow 10 child attributesHide child attributes
idintegerExample:1created_atstringExample:2026-01-15T09:30:00ZclientstringExample:stringsurfacestringExample:stringactionstringExample:stringverbstringExample:stringpathstringExample:stringtargetobject, nullableShow 2 child attributesHide child attributes
typestringExample:stringidstringExample:string
statusstringExample:stringchangesarray of objectsShow 6 child attributesHide child attributes
modelstringExample:stringidstringExample:stringopstringExample:stringfieldsarray of stringsbeforeobjectShow 1 child attributeHide child attributes
preorder_button_textstring
afterobjectShow 1 child attributeHide child attributes
preorder_button_textstring
metaobjectPagination for the list.
Show 4 child attributesHide child attributes
total_countintegerItems matching the filters, across all pages.
pageintegerPage returned, starting at 1.
per_pageintegerMost items per page.
total_pagesintegerPages available at this per_page; 0 when nothing matches.
Errors
invalid_paramsOne or more fields failed the action's schema.
validation_failedThe request failed validation.
Any request can also fail with auth_invalid (401) or rate_limited (429).
Every error has the same shape: see Errors and the list of error codes.
curl "https://app.stoqapp.com/api/v2/external/account/agent_activity" \
-H "X-Auth-Token: $STOQ_API_KEY"const res = await fetch("https://app.stoqapp.com/api/v2/external/account/agent_activity", {
headers: {
"X-Auth-Token": process.env.STOQ_API_KEY,
},
});
const data = await res.json();import os
import requests
res = requests.get(
"https://app.stoqapp.com/api/v2/external/account/agent_activity",
headers={"X-Auth-Token": os.environ["STOQ_API_KEY"]},
)
data = res.json()require "net/http"
require "json"
uri = URI("https://app.stoqapp.com/api/v2/external/account/agent_activity")
req = Net::HTTP::Get.new(uri, "X-Auth-Token" => ENV["STOQ_API_KEY"])
res = Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |http| http.request(req) }
data = JSON.parse(res.body)curl "https://app.stoqapp.com/api/v2/external/account/agent_activity?surface=api&status=succeeded" \
-H "X-Auth-Token: $STOQ_API_KEY"const res = await fetch("https://app.stoqapp.com/api/v2/external/account/agent_activity?surface=api&status=succeeded", {
headers: {
"X-Auth-Token": process.env.STOQ_API_KEY,
},
});
const data = await res.json();import os
import requests
res = requests.get(
"https://app.stoqapp.com/api/v2/external/account/agent_activity?surface=api&status=succeeded",
headers={"X-Auth-Token": os.environ["STOQ_API_KEY"]},
)
data = res.json()require "net/http"
require "json"
uri = URI("https://app.stoqapp.com/api/v2/external/account/agent_activity?surface=api&status=succeeded")
req = Net::HTTP::Get.new(uri, "X-Auth-Token" => ENV["STOQ_API_KEY"])
res = Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |http| http.request(req) }
data = JSON.parse(res.body){
"entries": [
{
"id": 1,
"created_at": "2026-01-15T09:30:00Z",
"client": "string",
"surface": "string",
"action": "string",
"verb": "string",
"path": "string",
"target": {
"type": "string",
"id": "string"
},
"status": "string",
"changes": [
{
"model": "string",
"id": "string",
"op": "string",
"fields": [
null
],
"before": {
"preorder_button_text": null
},
"after": {
"preorder_button_text": null
}
}
]
}
],
"meta": {
"total_count": 1,
"page": 1,
"per_page": 1,
"total_pages": 1
}
}{
"errors": [
"Invalid API key"
],
"code": "auth_invalid",
"details": [
{
"code": "auth_invalid",
"message": "Invalid API key",
"path": null,
"value": null,
"expected": null
}
]
}{
"errors": [
"name is required"
],
"code": "validation_failed",
"details": [
{
"code": "validation_failed",
"message": "name is required",
"path": null,
"value": null,
"expected": null
}
]
}{
"errors": [
"Rate limit exceeded"
],
"code": "rate_limited",
"details": [
{
"code": "rate_limited",
"message": "Rate limit exceeded",
"path": null,
"value": null,
"expected": null
}
]
}