---
title: "Update BigCommerce agent"
method: PUT
path: "/bigcommerce/channels/{channelId}/agents/{agentId}"
tags: ["Agent", "BigCommerce"]
---

# Update BigCommerce agent

`PUT /bigcommerce/channels/{channelId}/agents/{agentId}`

## Request

- Base URL: `https://api.takeshape.io`
- URL: `https://api.takeshape.io/bigcommerce/channels/{channelId}/agents/{agentId}`
- Auth: HTTP bearer

Updates a specific BigCommerce agent configuration.

## Path parameters

- `channelId` number, required
- `agentId` string, required

## Request body

- AgentUpdateBody
  - `systemPrompt` string, nullable: Custom system prompt for the agent. Pass null to clear.
  - `disabled` boolean, nullable: Whether the agent is disabled. Pass true to disable, false to enable.
  - `targetSelector` string, nullable: CSS selector for where the agent should be active. Pass null to clear.

## Response `200`

Updated agent with configuration

- Agent
  - `id` string, required: The encoded ID of the agent
  - `name` string, required: The name of the agent
  - `title` string, required: The title of the agent
  - `description` string, required: The description of the agent
  - `status` 'active' | 'disabled', required: The status of the agent
  - `systemPrompt` string: Custom system prompt for the agent
  - `systemPromptDefault` string, required: Default system prompt for the agent
  - `inputName` string, required: The name of the BigCommerce API input associated with the agent
  - `targetSelector` string: CSS selector for where the agent should be active
  - `targetSelectorDefault` string, required: Default CSS selector for where the agent should be active

## Other responses

- `400`: Bad Request - invalid or missing parameters
- `401`: Unauthorized - invalid or missing store token

---

[API](https://skmtc.dev/takeshape/apis/takeshape-rest-api.md) - [All operations](https://skmtc.dev/takeshape/apis/takeshape-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/takeshape/apis/takeshape-rest-api/revisions/2e088f4d4c64?raw)