> ## Documentation Index > Fetch the complete documentation index at: https://widgetic.com/llms.txt > Use this file to discover all available pages before exploring further. # Give a managed user a copy of one of your presets > Copies the preset `key` (see `setPartnerPreset`) onto a new canvas for one of your managed users, so their widget creator opens on a widget of their own that starts from yours. The copy is a draft widget in your account, filed under the managed user: `getAllWidgets` with `managedUserId` lists it, and no other managed user's editor can reach it. The copy carries the preset's code, design and content schemas, and thumbnail, and starts from a fork of its code repository, so the user's chat edits begin where yours left off. It does not carry the preset's database or its compositions. It is not a preset itself, and changing or removing the preset afterwards never touches it. To start a composition (the content and design editor) instead, you do not need a copy: call `createComposition` with the preset's `widgetId` (from `listPartnerPresets`) and the managed user. The `Idempotency-Key` header is required (`400` without it). Send the same key when you retry, so one copy is made, not two. A copy that could not be made leaves nothing behind (503 `PRESET_COPY_FAILED`). The managed user must be yours and active. ## OpenAPI ````yaml /openapi/widgetic-api-public.json post /managed-users/{id}/presets/{key}/copy openapi: 3.0.0 info: title: Widgetic API Gateway version: 1.0.0 description: API documentation for the Widgetic API Gateway license: name: Widgetic Integration License url: https://docs.widgetic.com/resources/license servers: - url: https://api.widgetic.com/v1 description: Production server variables: env: default: production description: Environment apiUrl: default: https://api.widgetic.com description: API URL apiVersion: default: /v1 description: API Version path prefix security: [] tags: [] paths: /managed-users/{id}/presets/{key}/copy: post: tags: - Managed Users summary: Give a managed user a copy of one of your presets description: > Copies the preset `key` (see `setPartnerPreset`) onto a new canvas for one of your managed users, so their widget creator opens on a widget of their own that starts from yours. The copy is a draft widget in your account, filed under the managed user: `getAllWidgets` with `managedUserId` lists it, and no other managed user's editor can reach it. The copy carries the preset's code, design and content schemas, and thumbnail, and starts from a fork of its code repository, so the user's chat edits begin where yours left off. It does not carry the preset's database or its compositions. It is not a preset itself, and changing or removing the preset afterwards never touches it. To start a composition (the content and design editor) instead, you do not need a copy: call `createComposition` with the preset's `widgetId` (from `listPartnerPresets`) and the managed user. The `Idempotency-Key` header is required (`400` without it). Send the same key when you retry, so one copy is made, not two. A copy that could not be made leaves nothing behind (503 `PRESET_COPY_FAILED`). The managed user must be yours and active. operationId: copyPresetForManagedUser parameters: - in: path name: id required: true schema: type: string format: uuid description: The managed user to give the copy to (Widgetic's id for the user) - in: path name: key required: true schema: type: string pattern: ^[a-z0-9][a-z0-9_-]{0,63}$ description: The key of the preset to copy - $ref: '#/components/parameters/IdempotencyKeyRequired' requestBody: required: false content: application/json: schema: $ref: '#/components/schemas/CopyPartnerPresetRequest' responses: '201': description: The copy was made content: application/json: schema: $ref: '#/components/schemas/PartnerPresetCopyResponse' '400': description: >- The key or the name is malformed, or the Idempotency-Key header is missing content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '403': description: Forbidden - the caller is not a partner content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '404': description: >- No such managed user on your account (`MANAGED_USER_NOT_FOUND`), or no preset with this key (`PRESET_NOT_FOUND`) content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '409': description: >- The managed user is switched off, so nothing new can be made for it (`MANAGED_USER_INACTIVE`) content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '503': description: >- The copy could not be made right now (`PRESET_COPY_FAILED`). Nothing was created; ask again. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' security: - apiKeyAuth: [] x-code-samples: - lang: TypeScript label: TypeScript SDK source: > import { randomUUID } from 'node:crypto'; import { Configuration, ManagedUsersApi } from '@widgetic/api-sdk-ts'; const managedUsersApi = new ManagedUsersApi(new Configuration({ apiKey: 'YOUR_API_KEY' })); // Give one of your users their own copy of the preset you registered as "rating": // The call needs an idempotency key: reuse the same key if you retry this call. const { data: copy } = await managedUsersApi.copyPresetForManagedUser({ id: managedUserId, key: 'rating', idempotencyKey: randomUUID(), }); // Open the widget creator on copy.canvasId and copy.widgetId. components: parameters: IdempotencyKeyRequired: in: header name: Idempotency-Key required: true description: >- Required: a call without it is refused with `400`. A key of your own that names this one request; a UUID is ideal. It is 8 to 50 characters of letters, digits, `-` and `_`. Send the same key again when you retry (after a timeout, a dropped connection or a `5xx`) and the call is carried out once: the retry gets the first answer back, marked `X-Idempotency-Cached: true`. The same key with a different body is refused with `422`, and a retry that arrives while the first call is still running with `409` (see `Retry-After`). schema: type: string minLength: 8 maxLength: 50 pattern: ^[a-zA-Z0-9_-]{8,50}$ example: 9b2d6f0a-3c41-4e5a-8d77-1f2e3a4b5c6d schemas: CopyPartnerPresetRequest: type: object additionalProperties: false properties: name: type: string minLength: 1 maxLength: 120 description: >- Names the copy. Left out, the copy is named after the preset's title, or the widget's own name. example: name: Example name PartnerPresetCopyResponse: type: object required: - success - data properties: success: type: boolean description: Always `true` on a success. example: true data: $ref: '#/components/schemas/PartnerPresetCopy' meta: $ref: '#/components/schemas/ResponseMeta' ErrorResponse: type: object required: - success - message - error additionalProperties: true properties: success: type: boolean description: Always `false` on a failure. example: false message: type: string description: The same text as `error.message`, for a caller that reads one line. error: $ref: '#/components/schemas/ErrorDetail' PartnerPresetCopy: type: object description: >- Where the copy of a preset is. Open the widget creator on `canvasId` and `widgetId`. required: - presetKey - managedUserId - canvasId - widgetId - widgetName - warnings properties: presetKey: type: string example: rating managedUserId: type: string format: uuid description: The managed user the copy was made for canvasId: type: string format: uuid description: The new canvas the copy is on widgetId: type: string format: uuid description: >- The new widget, which is not a preset and which only this managed user's editor reaches widgetName: type: string warnings: type: array description: >- Things that did not go as planned but did not stop the copy. Empty when everything did. items: type: string example: presetKey: rating managedUserId: 3fa85f64-5717-4562-b3fc-2c963f66afa6 canvasId: 3fa85f64-5717-4562-b3fc-2c963f66afa6 widgetId: 3fa85f64-5717-4562-b3fc-2c963f66afa6 widgetName: Example widgetName warnings: [] ResponseMeta: type: object description: >- Extra information about the answer: where a page sits in a list, the cursor of the next page, or warnings about a call that succeeded with a caveat. additionalProperties: true properties: page: type: integer description: The page that was read, counting from 1. example: 1 size: type: integer description: How many items one page holds. example: 20 total: type: integer description: How many items the whole list has. example: 135 limit: type: integer description: The same as `size`. example: 20 offset: type: integer description: How many items come before this page. example: 0 hasNextPage: type: boolean example: true hasPreviousPage: type: boolean example: false nextCursor: type: string nullable: true description: >- Pass this as `cursor` to read the next page of a list that is read by cursor. `null` on the last page. warnings: type: array items: type: string description: >- Things the call did not do, though it succeeded (for example a table that could not be created just now). ErrorDetail: type: object required: - code - message - timestamp properties: code: type: string description: Machine-readable error code. example: RESOURCE_NOT_FOUND message: type: string description: Human-readable explanation. example: Composition not found param: type: string description: The field that caused the error, when one did. example: name docUrl: type: string description: Where this error is explained. suggestedAction: type: string description: What to do about it. retryAfter: type: integer description: >- Seconds to wait before trying again (rate limits). The same number is in the `Retry-After` header. example: 60 details: type: object additionalProperties: true description: >- More about the error: the fields that failed, a limit that was reached. correlationId: type: string description: Quote this when you ask support about the call. example: req_123e4567-e89b-12d3-a456-426614174000 timestamp: type: string format: date-time example: '2026-10-15T10:00:00.000Z' securitySchemes: apiKeyAuth: type: http scheme: bearer bearerFormat: JWT ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.