---
title: "Create an agent configuration"
method: POST
path: "/api/w/{wId}/assistant/agent_configurations"
tags: ["Private Agents"]
---

# Create an agent configuration

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

Creates a new agent configuration in the workspace.

## Path parameters

- `wId` string, required

## Request body

- object
  - `assistant` object, required — Agent configuration to create

## Response `200`

Success

- object
  - `agentConfiguration` PrivateLightAgentConfiguration — Agent configuration as returned by the private list endpoint.
    - `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)