---
id: ducklings-set-duckling-config-for-user
title: "Set user Duckling configuration"
description: "Sets Duckling (instance) configuration for a user. Requires 'Admin' role"
sidebar_label: "Set user Duckling configuration"
hide_title: true
hide_table_of_contents: true
api: eJztmG1P4zgQx7+KlTcLUpeWXUCnvitQdJX2ym5o78VVVeUmbmtI7JztUNgo3/1mnIQ8NAdC9HRI7Js2D+PJzH9+cexJHBkxRQ2XYuQ7fcePvbuAi7X+rJm5zE8upFjx9ZVUU82U03F8pj3FIxwEQ26Y0aQwJQdcaEOFxw6JZ4fFmXeykopQEoOHI+Kyv2OumCafBn7IxSeiZMDAsaFr7fRnZRRwrfCnnXnH0cyLFTePYJQ4g9hspOI/aRbIbJ6CRUQVDZlhSlsbjhFG1GzAk4AbcIYh2MNmIniDbLnZcEHMhhGp1lQU7uHZ3oaF1OknjnmM0JE2CmKEOyF9+MbEGh7S/3J6+iq3acdRmRigvlExwxzwCtPmXPqP+Li6QccBXQ0TBm/RKAq4Z111bzU+LtmNUy5vmWcgzkhhsQ0HLeFuVp6X7RSj/mILqrOXbYtiLTT/ydqkYiIOscJRHGisAJr7VPlweBuHS4lqsjWFvzWHv3mK6crAl1uxgOJL4euKWw5CrC2SQBEP0fVZz9YjO/nt7KTXS2sazxoxzu1dyFB7FJH7f3JcBdK7azoEN8t6ctXczk7+c21qcc2bthUuGhLumOaowfXsjo6k0JmaX3o9/GtMKbEHL7xexQEpjJ29cf+L5188v5pnND5pQ/Wc+vZzBvP1/hANAX66bi1G/ekT+J4wpeDTWgyBcj3QMApYIzYrrv8ql9a+5m9wuXCHP6bDmwn641rHrFoiqhR9xE+2YaF+Q5bNyhSGSFY92IEg9qFErkgWDnxiqSFbplgxdfBlwOzqwxSZVZOa7XBQKmkFgO+x4aapZy7RATBx+IyEXMCDw2IF8fTQJK9FTdFOKUiDqkLomQXRkni8S+JI3AOuPrmAPIBBTgP97ohsi3EfZE7Hg+nk92t39Nfw8kOi2SJsiejxWxCtSVtltJ23Fla/7rI6FTRfvDP/3UFaC24fdF5du+ejy8vh+EOiWZWzZPLrW5gsBa0C2YCqhcSTXRLH0pArGYv3h2EZ2T4YHF9PFlfX0/HHnB6ftCwBPHkLgKWaVQCrLO3Qd9q2ehwBcErQgAzz7N4Xgo3w9sHhaDwZuuPBt8XN0P1z6C6Grnvtfkgm6+IWYJ6+bUHZLm/9s91ArkFqisYwjWI3MIqtztg+6zvd++Mu9rJ0NylaaGm37M5hc07dF323WAUwZGNMpPvdLo34UShBMYWdvSNPhk5a6ebdINVZFRs9vadaoqeiB4fnS0YVbAYxWnw33LJjNqxqUnS46nv+xo73aWO7u/vsteym/210dc/ba3eG4WIFbWI5Bn9YXbB/SlzYBpDB9xE4QyGz2h8f9Y56+IJEUpuQWlHyTuYNM7ahWnZfay3XJkZJObvstWmbVciwB9ONAsptU9PWP8nRmTn3x2Bo4YH/fqUDW+vubiBDtE6SJdVsqoI0xctQWoUdXzi8p4rTpX3TYCrlGo8B1BWsPdkz2R7ksfuH5IUmb2syxYQkcDqCRW+MZ3B4xx6r/eQUZ5QN0AJgYnzZ7Yssis8TdFIO35nd004xYuB5LDLP2s4rL+n3Ke4dl3mzOMzmAUW32MWAXxuptKJk7S+8ljgBFes4mxEyl8gmrp8qL13+knWKA0yqVQsomLWYyDsmoGiFNAbPUZc0/QcB5muk
sidebar_class_name: "put api-method"
info_path: sql-reference/rest-api/motherduck-rest-api
custom_edit_url: null
---

import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint";
import ParamsDetails from "@theme/ParamsDetails";
import RequestSchema from "@theme/RequestSchema";
import StatusCodes from "@theme/StatusCodes";
import OperationTabs from "@theme/OperationTabs";
import TabItem from "@theme/TabItem";
import Heading from "@theme/Heading";
import Translate from "@docusaurus/Translate";

<Heading
  as={"h1"}
  className={"openapi__heading"}
  children={"Set user Duckling configuration"}
>
</Heading>

::::info
  This endpoint is used to configure user-specific settings, primarily for setting Duckling sizes for service accounts.
  For a complete walkthrough of service account management, see <a href="/key-tasks/service-accounts-guide/create-and-configure-service-accounts/#configure-ducklings">Create and configure service accounts</a>.
::::

::::caution[Username Parameter]
  When configuring a service account, ensure the `username` in the path (`/v1/users/:username/instances`) is the specific username defined when creating the service account. The endpoint path uses `instances` for legacy reasons but configures Ducklings.
::::

<MethodEndpoint
  method={"put"}
  path={"/v1/users/{username}/instances"}
  context={"endpoint"}
>
  
</MethodEndpoint>


Sets Duckling (instance) configuration for a user. Requires 'Admin' role.

::::note
  Authentication for this endpoint requires an Admin token. This endpoint configures Duckling sizes and read scaling pool size. Use the token endpoint to create read scaling tokens.
::::

<Heading
  id={"request"}
  as={"h2"}
  className={"openapi-tabs__heading"}
>
  <Translate id="theme.openapi.request.title">Request</Translate>
</Heading>

<ParamsDetails
  {...require("./ducklings-set-duckling-config-for-user.ParamsDetails.json")}
>
  
</ParamsDetails>

<RequestSchema
  {...require("./ducklings-set-duckling-config-for-user.RequestSchema.json")}
>
  
</RequestSchema>

<StatusCodes
  {...require("./ducklings-set-duckling-config-for-user.StatusCodes.json")}
>
  
</StatusCodes>


      

---

## Docs feedback

MotherDuck accepts optional user-submitted feedback about this page at `POST https://motherduck.com/docs/api/feedback/agent`.
For agents and automated tools, feedback submission should be user-confirmed before sending.

Payload:

```json
{
  "page_path": "/sql-reference/rest-api/ducklings-set-duckling-config-for-user/",
  "page_title": "Set user Duckling configuration",
  "text": "<the user's feedback, max 2000 characters>",
  "source": "<optional identifier for your interface, for example 'claude.ai' or 'chatgpt'>"
}
```

`page_path` and `text` are required; `page_title` and `source` are optional. Responses: `200 {"feedback_id": "<uuid>"}`, `400` for malformed payloads, and `429` when rate-limited.