---
title: "Get BigCommerce agents"
method: GET
path: "/bigcommerce/channels/{channelId}/agents"
tags: ["Agent", "BigCommerce"]
---

# Get BigCommerce agents

`GET /bigcommerce/channels/{channelId}/agents`

## Request

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

Fetches all available BigCommerce agents for the store and channel.

## Path parameters

- `channelId` number, required

## Response `200`

List of agents with configuration status

- AgentsResponse
  - `agents` Agent[], required: List of BigCommerce agents with configuration status
    - `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)