> ## Documentation Index
> Fetch the complete documentation index at: https://developers.redo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# commerceAgentConfigChanges

> Edits and publishes of the store's Commerce Agent config, newest first, and who made each. Pass `strategyId` for one strategy's changes instead. Publishes are listed from November 2026.

**Required scopes:** [`commerce_agent_settings_read`](https://developers.redo.com/docs/api-reference/v3/reference/scopes#scope-commerce_agent_settings_read)

## Arguments

**after** `String`

Forward pagination cursor — returns changes after it.

**before** `String`

Backward pagination cursor — returns changes before it.

**first** `Int`

Forward pagination: returns the first N changes (max 100, default 25). Use with `after`; mutually exclusive with `last`/`before`.

**last** `Int`

Backward pagination: returns the last N changes (max 100, default 25). Use with `before`; mutually exclusive with `first`/`after`.

**strategyId** `ID`

A strategy's `id`, to list its changes.

## Returns

**commerceAgentConfigChanges** `[CommerceAgentConfigChangeConnection!](/docs/api-reference/v3/pagination)` *required*

A paginated list of CommerceAgentConfigChange items.

**fields**

**edges** `[\[CommerceAgentConfigChangeEdge!\]!](/docs/api-reference/v3/pagination)` *required*

The list of edges (each a node plus its pagination `cursor`).

**fields**

**cursor** `String!` *required*

Opaque cursor for this item; pass to `after`/`before` to page from here.

**node** `[CommerceAgentConfigChange!](/docs/api-reference/v3/reference/commerce-agent/commerce-agent-config-change)` *required*

The item at this edge.

**fields**

**actor** `[CommerceAgentChangeActor!](/docs/api-reference/v3/reference/commerce-agent/commerce-agent-change-actor)` *required*

Who made the change.

**apiKey** `[ServiceUserApiKey](/docs/api-reference/v3/reference/service-users/service-user-api-key)`

The API key an API caller signed in with. Null for people, for other kinds of credential, and once the key is deleted.

**Requires:** [`user_read`](https://developers.redo.com/docs/api-reference/v3/reference/scopes#scope-user_read)

**createdAt** `[DateTime!](/docs/api-reference/v3/reference/common/date-time)` *required*

When the change was made.

**kind** `[CommerceAgentConfigChangeKind!](/docs/api-reference/v3/reference/commerce-agent/commerce-agent-config-change-kind)` *required*

What the change did.

**serviceUser** `[ServiceUser](/docs/api-reference/v3/reference/service-users/service-user)`

The service account an API caller signed in as. Null for people, and for changes recorded before it was tracked.

**Requires:** [`user_read`](https://developers.redo.com/docs/api-reference/v3/reference/scopes#scope-user_read)

**strategyId** `ID`

The strategy a strategy change belongs to. Null on config changes.

**teamMember** `[TeamMember](/docs/api-reference/v3/reference/common/team-member)`

The team member behind the change. Null for Redo staff, for an API key with no user, or when the user no longer exists.

**Requires:** [`user_read`](https://developers.redo.com/docs/api-reference/v3/reference/scopes#scope-user_read)

**nodes** `[\[CommerceAgentConfigChange!\]!](/docs/api-reference/v3/reference/commerce-agent/commerce-agent-config-change)` *required*

The nodes in this page, without the edge/cursor wrapper — a convenience over `edges`.

**fields**

**actor** `[CommerceAgentChangeActor!](/docs/api-reference/v3/reference/commerce-agent/commerce-agent-change-actor)` *required*

Who made the change.

**apiKey** `[ServiceUserApiKey](/docs/api-reference/v3/reference/service-users/service-user-api-key)`

The API key an API caller signed in with. Null for people, for other kinds of credential, and once the key is deleted.

**Requires:** [`user_read`](https://developers.redo.com/docs/api-reference/v3/reference/scopes#scope-user_read)

**fields**

**createdAt** `[DateTime!](/docs/api-reference/v3/reference/common/date-time)` *required*

When the credential was created.

**id** `ID!` *required*

The id of this credential.

**lastUsedAt** `[DateTime](/docs/api-reference/v3/reference/common/date-time)`

When the credential last authenticated, or null if it never has.

**name** `String!` *required*

A label that helps recognize the credential.

**suffix** `String!` *required*

The key's last four characters, to tell keys apart.

**createdAt** `[DateTime!](/docs/api-reference/v3/reference/common/date-time)` *required*

When the change was made.

**kind** `[CommerceAgentConfigChangeKind!](/docs/api-reference/v3/reference/commerce-agent/commerce-agent-config-change-kind)` *required*

What the change did.

**serviceUser** `[ServiceUser](/docs/api-reference/v3/reference/service-users/service-user)`

The service account an API caller signed in as. Null for people, and for changes recorded before it was tracked.

**Requires:** [`user_read`](https://developers.redo.com/docs/api-reference/v3/reference/scopes#scope-user_read)

**fields**

**apiKeys** `[\[ServiceUserApiKey!\]!](/docs/api-reference/v3/reference/service-users/service-user-api-key)` *required*

Its API keys, newest first.

**clientId** `String!` *required*

The OAuth client ID its public keys sign assertions with, as `iss` and `sub`.

**createdAt** `[DateTime!](/docs/api-reference/v3/reference/common/date-time)` *required*

When it was created.

**createdBy** `[TeamMember](/docs/api-reference/v3/reference/common/team-member)`

The team member who created it. Null when a partner or another service account created it, or the user no longer exists.

**Requires:** [`user_read`](https://developers.redo.com/docs/api-reference/v3/reference/scopes#scope-user_read)

**federatedPolicies** `[\[ServiceUserFederatedPolicy!\]!](/docs/api-reference/v3/reference/service-users/service-user-federated-policy)` *required*

Its federated policies, newest first.

**id** `ID!` *required*

The id of this service account.

**managedBy** `[ServiceUserManager!](/docs/api-reference/v3/reference/service-users/service-user-manager)` *required*

Who manages it.

**name** `String!` *required*

A label that helps recognize the service account.

**publicKeys** `[\[ServiceUserPublicKey!\]!](/docs/api-reference/v3/reference/service-users/service-user-public-key)` *required*

Its public keys, newest first.

**scopes** `[\[ApiScope!\]!](/docs/api-reference/v3/reference/service-users/api-scope)` *required*

What its credentials may access.

**status** `[ServiceUserStatus!](/docs/api-reference/v3/reference/service-users/service-user-status)` *required*

Whether its credentials authenticate.

**updatedAt** `[DateTime!](/docs/api-reference/v3/reference/common/date-time)` *required*

When it was last updated.

**strategyId** `ID`

The strategy a strategy change belongs to. Null on config changes.

**teamMember** `[TeamMember](/docs/api-reference/v3/reference/common/team-member)`

The team member behind the change. Null for Redo staff, for an API key with no user, or when the user no longer exists.

**Requires:** [`user_read`](https://developers.redo.com/docs/api-reference/v3/reference/scopes#scope-user_read)

**fields**

**email** `String`

Email address. Null when the user has none.

**id** `ID!` *required*

m\_us\_… id, the same id the app and MCP tools use.

**name** `String`

Display name. Null when the user hasn't set one.

**supportShiftStatus** `[SupportShiftStatus!](/docs/api-reference/v3/reference/support/support-shift-status)` *required*

The agent's live shift status, worked out when the request runs.

**Requires:** [`support_config_read`](https://developers.redo.com/docs/api-reference/v3/reference/scopes#scope-support_config_read)

**supportWorkSchedule** `[SupportWorkSchedule!](/docs/api-reference/v3/reference/support/support-work-schedule)` *required*

The agent's support working hours. An agent with no saved schedule returns enabled false.

**Requires:** [`team_members_manage`](https://developers.redo.com/docs/api-reference/v3/reference/scopes#scope-team_members_manage)

**pageInfo** `[PageInfo!](/docs/api-reference/v3/pagination)` *required*

Pagination metadata for the current page.

**fields**

**endCursor** `String`

Cursor of the last edge in this page; pass to `after` to page forward.

**hasNextPage** `Boolean!` *required*

Whether more items exist after this page (drives forward pagination with `first`/`after`).

**hasPreviousPage** `Boolean!` *required*

Whether more items exist before this page (drives backward pagination with `last`/`before`).

**startCursor** `String`

Cursor of the first edge in this page; pass to `before` to page backward.

## Example

```graphql theme={null}
query {
  commerceAgentConfigChanges(after: "...", before: "...", first: 10, last: 10, strategyId: "...") {
    nodes {
      actor
      createdAt
      kind
      strategyId
    }
    pageInfo { hasNextPage endCursor }
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.