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

# List agent configurations

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

Returns all agent configurations in the workspace.

## Path parameters

- `wId` string, required

## Query parameters

- `view` 'all' | 'analytics' | 'list' | 'favorites' | 'published' | 'admin_internal' | 'manage_unrestricted' | 'global' | 'workspace'
- `limit` integer
- `withUsage` 'true'
- `withAuthors` 'true'
- `withFeedbacks` 'true'
- `withEditors` 'true'
- `sort` string

## Response `200`

Success

- object
  - `agentConfigurations` PrivateLightAgentConfiguration[]
    - `id` integer, required
    - `sId` string, required
    - `version` integer, required
    - `versionCreatedAt` string, nullable
    - `versionAuthorId` integer, nullable
    - `name` string, required
    - `description` string, required
    - `instructions` string, nullable
    - `pictureUrl` string, required
    - `status` 'active' | 'archived' | 'draft' | 'pending' | 'disabled_by_admin' | 'disabled_missing_datasource' | 'disabled_free_workspace', required — Agent status
    - `scope` 'global' | 'visible' | 'hidden', required
    - `userFavorite` boolean
    - `model` object, required
      - `providerId` string
      - `modelId` string
      - `temperature` number
      - `reasoningEffort` 'none' | 'light' | 'medium' | 'high'
    - `maxStepsPerRun` integer, required
    - `tags` object[], required
      - `sId` string
      - `name` string
    - `templateId` string, nullable
    - `requestedGroupIds` array[]
      - string[]
    - `requestedSpaceIds` string[]
    - `canRead` boolean
    - `canEdit` boolean
    - `lastAuthors` string[] — Optional, returned when withAuthors query param is set
    - `editors` object[] — Optional, returned when withEditors query param is set
      - `sId` string
      - `fullName` string
      - `image` string, nullable
    - `usage` object — Optional, returned when withUsage query param is set
      - `messageCount` integer
      - `conversationCount` integer
      - `userCount` integer
      - `timePeriodSec` integer
    - `feedbacks` object — Optional, returned when withFeedbacks query param is set
      - `up` integer
      - `down` integer

## Other responses

- `401` — Unauthorized

---

[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/2e785b62895f/schema)