---
title: "Import agent configuration"
method: POST
path: "/api/v1/w/{wId}/assistant/agent_configurations/import"
tags: ["Agents"]
---

# Import agent configuration

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

Create a new agent configuration from a JSON body matching the agent config schema.

## Path parameters

- `wId` string, required

## Request body

- object
  - `agent` object, required
    - `handle` string, required
    - `description` string, required
    - `scope` 'visible' | 'hidden', required
    - `avatar_url` string, required
    - `max_steps_per_run` number, required
    - `visualization_enabled` boolean, required
  - `instructions` string, required
  - `generation_settings` object, required
    - `model_id` string
    - `provider_id` string
    - `temperature` number
    - `reasoning_effort` string
  - `tags` object[], required
    - `name` string
    - `kind` 'standard' | 'protected'
  - `editors` string[], required — Emails of the workspace members to set as editors of the agent.
  - `toolset` object[], required
    - `name` string
    - `description` string
    - `type` 'MCP'
    - `configuration` object

## Response `200`

Successfully created agent configuration

- object
  - `agentConfiguration` AgentConfiguration
    - `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
  - `skippedActions` object[]
    - `name` string
    - `reason` string

## Other responses

- `400` — Bad Request. Invalid request body.
- `401` — Unauthorized. Invalid or missing authentication token.
- `500` — Internal Server Error.

## Changes

- **2026-08-20** `477be28e5858` — 1 breaking
  - the request property `agent/avatar_url` became required
- **2026-08-13** `ad905257873c` — 1 breaking, 3 warning
  - the `editors/items/` request property type changed from `object` to `string`, and format from no format to `email`
  - removed the request property `editors/items/email`
  - removed the request property `editors/items/full_name`
  - removed the request property `editors/items/user_id`

[Change history](https://skmtc.dev/dust-tt/apis/dust-api-documentation/changes/api/v1/w/:wId/assistant/agent_configurations/import/post.md)

---

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