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

# commerceAgentStrategies

> Commerce Agent strategies on this store, newest first, optionally filtered by name. At most 100 are returned; narrow with `query` to reach older ones.

**Required scopes:** [`marketing_automations_read`](/docs/api-reference/v3/reference/scopes#scope-marketing_automations_read)

## Arguments

<ResponseField name="query" type="String">
  Case-insensitive substring match on the strategy name. At most 200 characters.
</ResponseField>

## Returns

<ResponseField name="commerceAgentStrategies" type={<a href="/docs/api-reference/v3/reference/marketing/commerce-agent-strategy">[CommerceAgentStrategy!]!</a>} required>
  Guidance for a Commerce Agent conversation started by a Start Agent Conversation automation step: the goal, how to write the outreach, and an optional discount code the agent may offer.

  <Expandable title="fields" lazyRender>
    <ResponseField name="createdAt" type={<a href="/docs/api-reference/v3/reference/common/date-time">DateTime!</a>} required>
      When the strategy was created.
    </ResponseField>

    <ResponseField name="discountCodeId" type="ID">
      The DiscountCode the Commerce Agent may offer. Null when there is none, or when the discount code was deleted.
    </ResponseField>

    <ResponseField name="goalGuidance" type="String">
      What the Commerce Agent should accomplish in the conversation.
    </ResponseField>

    <ResponseField name="id" type="ID!" required>
      The id of this strategy. Set it as `strategyId` on a Start Agent Conversation step.
    </ResponseField>

    <ResponseField name="name" type="String!" required>
      Merchant-facing name.
    </ResponseField>

    <ResponseField name="outreachGuidance" type="String">
      How the Commerce Agent should write its first message and replies.
    </ResponseField>

    <ResponseField name="updatedAt" type={<a href="/docs/api-reference/v3/reference/common/date-time">DateTime!</a>} required>
      When the strategy was last changed.
    </ResponseField>
  </Expandable>
</ResponseField>

## Example

```graphql theme={null}
query {
  commerceAgentStrategies(query: "...") {
    createdAt
    discountCodeId
    goalGuidance
    id
    name
    outreachGuidance
    updatedAt
  }
}
```


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