---
title: "List agents"
method: GET
path: "/api/v1/w/{wId}/assistant/agent_configurations"
tags: ["Agents"]
---

# List agents

`GET /api/v1/w/{wId}/assistant/agent_configurations`

Get the agent configurations for the workspace identified by {wId}.

## Path parameters

- `wId` string, required

## Query parameters

- `view` 'all' | 'list' | 'workspace' | 'published' | 'global' | 'favorites'
- `withAuthors` 'true' | 'false'

## Response `200`

Agent configurations for the workspace

- object
  - `agentConfigurations` AgentConfiguration[] — Array of agent configurations, optionally including lastAuthors if withAuthors=true
    - `id` integer
    - `sId` string — Unique string identifier for the agent configuration
    - `version` integer
    - `versionCreatedAt` string, nullable — Timestamp of when the version was created
    - `versionAuthorId` string, nullable — ID of the user who created this version
    - `name` string — Name of the agent configuration
    - `description` string — Description of the agent configuration
    - `instructions` string, nullable — Instructions for the agent
    - `pictureUrl` string — URL of the agent's picture
    - `status` string — Current status of the agent configuration
    - `scope` string — Scope of the agent configuration
    - `userFavorite` boolean — Status of the user favorite for this configuration
    - `model` object
      - `providerId` string — ID of the model provider
      - `modelId` string — ID of the specific model
      - `temperature` number
    - `actions` unknown[]
      - unknown
    - `maxStepsPerRun` integer
    - `templateId` string, nullable — ID of the template used for this configuration

## Other responses

- `400` — Bad Request. Missing or invalid parameters.
- `401` — Unauthorized. Invalid or missing authentication token, or attempting to access restricted views without authentication.
- `404` — Workspace not found.
- `500` — Internal Server Error.

---

[API](https://skmtc.net/dust-tt/apis/dust-api-documentation.md) · [All operations](https://skmtc.net/dust-tt/apis/dust-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/dust-tt/dust-api-documentation/revisions/24a308e0da1c/schema)