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

# Commerce Agent

> Commerce Agent knowledge articles the agent uses to answer shoppers.

## Queries

* [`knowledgeArticle`](/docs/api-reference/v3/reference/commerce-agent/queries/knowledge-article) — Fetch a single Commerce Agent knowledge article by its id.
* [`knowledgeArticles`](/docs/api-reference/v3/reference/commerce-agent/queries/knowledge-articles) — List Commerce Agent knowledge articles, optionally filtered by title/body substring, status, or origin.
* [`searchKnowledgeArticles`](/docs/api-reference/v3/reference/commerce-agent/queries/search-knowledge-articles) — Ranked text search over Commerce Agent knowledge articles, including drafts and disabled articles. Ranking is not keyset-paginated; cap results with `first`.

## Mutations

* [`createKnowledgeArticle`](/docs/api-reference/v3/reference/commerce-agent/mutations/create-knowledge-article) — Create a Commerce Agent knowledge article. Defaults to DRAFT so it is not retrievable until you set status to ACTIVE.
* [`deleteKnowledgeArticle`](/docs/api-reference/v3/reference/commerce-agent/mutations/delete-knowledge-article) — Delete a Commerce Agent knowledge article. Returns true if an owned article was deleted, false if none matched.
* [`updateKnowledgeArticle`](/docs/api-reference/v3/reference/commerce-agent/mutations/update-knowledge-article) — Update a Commerce Agent knowledge article. Returns null if no owned article matches the id.

## Objects

* [`KnowledgeArticle`](/docs/api-reference/v3/reference/commerce-agent/knowledge-article) — A Commerce Agent knowledge article the merchant authored or imported. Retrieval eligibility lives on `status` and the effective window, not on the body.

## Input objects

* [`CreateKnowledgeArticleInput`](/docs/api-reference/v3/reference/commerce-agent/create-knowledge-article-input) — Fields for a new Commerce Agent knowledge article. Defaults to DRAFT so nothing is retrievable until you set status to ACTIVE.
* [`UpdateKnowledgeArticleInput`](/docs/api-reference/v3/reference/commerce-agent/update-knowledge-article-input) — Fields to change. Omit a field to leave it unchanged. Sending `referencedProductFamilyIds` or `referencedArticleIds` replaces that set.

## Enums

* [`KnowledgeArticleOrigin`](/docs/api-reference/v3/reference/commerce-agent/knowledge-article-origin) — How this article was created. Immutable after create.
* [`KnowledgeArticleSortKey`](/docs/api-reference/v3/reference/commerce-agent/knowledge-article-sort-key) — A field this list can be ordered by; pass to the list's `orderBy` argument and pair with `reverse` to flip direction.
* [`KnowledgeArticleStatus`](/docs/api-reference/v3/reference/commerce-agent/knowledge-article-status) — Whether Commerce Agent may retrieve this article, independent of its schedule.


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