Skip to content

List agent activity

API v2 is in public beta: endpoints and fields can change before general availability. See the changelog

GET/account/agent_activity

Costs 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

  • clientstring

    Only writes by this client, as entries name it (e.g. Claude, ChatGPT, Quinn, API key).

  • surfacestring

    Only writes made through this surface, the REST API (api), MCP (mcp) or Quinn (quinn).

    One of apimcpquinn
  • statusstring

    Only writes with this outcome.

    One of succeededfailederror
  • target_typestring

    Only writes to this kind of resource, as entries name it (e.g. preorders/offers). Use with target_id.

  • sincestring

    Only writes at or after this time, ISO 8601 (e.g. 2026-11-01T00:00:00Z).

  • untilstring

    Only writes at or before this time, ISO 8601.

  • target_idstring

    Only writes to the resource with this id, with target_type.

  • pageinteger

    Page of results, from 1.

    Default 1
  • per_pageinteger

    Entries per page, at most 100.

    Default 25

Returns

  • entriesarray of objects
    Show 10 child attributesHide child attributes
    • idinteger
      Example: 1
    • created_atstring
      Example: 2026-01-15T09:30:00Z
    • clientstring
      Example: string
    • surfacestring
      Example: string
    • actionstring
      Example: string
    • verbstring
      Example: string
    • pathstring
      Example: string
    • targetobject, nullable
      Show 2 child attributesHide child attributes
      • typestring
        Example: string
      • idstring
        Example: string
    • statusstring
      Example: string
    • changesarray of objects
      Show 6 child attributesHide child attributes
      • modelstring
        Example: string
      • idstring
        Example: string
      • opstring
        Example: string
      • fieldsarray of strings
      • beforeobject
        Show 1 child attributeHide child attributes
        • preorder_button_textstring
      • afterobject
        Show 1 child attributeHide child attributes
        • preorder_button_textstring
  • metaobject

    Pagination for the list.

    Show 4 child attributesHide child attributes
    • total_countinteger

      Items matching the filters, across all pages.

    • pageinteger

      Page returned, starting at 1.

    • per_pageinteger

      Most items per page.

    • total_pagesinteger

      Pages available at this per_page; 0 when nothing matches.

Errors

422
invalid_params

One or more fields failed the action's schema.

422
validation_failed

The 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.

GET/account/agent_activity
curl "https://app.stoqapp.com/api/v2/external/account/agent_activity" \
  -H "X-Auth-Token: $STOQ_API_KEY"
Response
{
  "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
  }
}