Set user Duckling configuration
PUT/v1/users/:username/instances
Sets Duckling (instance) configuration for a service account or user account. Requires 'Admin' role.
This endpoint is used to configure settings for service accounts and user accounts, including Duckling sizes. For a complete walkthrough of service account management, see Create and configure service accounts.
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.
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.
cooldown_seconds cannot be set on Pulse instances: sending it for a Pulse read_write or read_scaling returns 400 "cooldown_seconds cannot be set for Pulse instances". For larger sizes, omitting cooldown_seconds applies the default of 60 seconds (the minimum); when set explicitly it must be between 60 and 86400 seconds.
Request
Responses
- 200
- 400
- 401
- 403
- 404
- 500
Successful response
Bad Request
Invalid Credentials
Unauthorized
Not Found
Internal Error