> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cakto.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Duplicar Produto

> Cria uma cópia de um produto existente

#### Escopo

```bash theme={null}
    write products
```

## Notas

> [!NOTE]
>
> * O produto duplicado recebe um novo Id único
> * As relações são duplicadas com novos IDs: ofertas, checkouts, links, order bumps, entregas de conteúdo, métodos de pagamento e pixels de rastreamento
> * Pixels vinculados a afiliados **não** são copiados
> * O nome recebe o sufixo ` - Cópia` (ex.: `Curso de Fotografia - Cópia`). Como o nome aceita até 255 caracteres, o de mais de 247 é cortado no fim para caber o sufixo
> * O produto duplicado **herda o `status` do produto original** — se o original estiver inativo, a cópia também estará
> * As métricas de vendas da cópia começam zeradas
> * Produto com o pagamento por cartão bloqueado não é duplicado, em nenhuma moeda: a resposta é `400` com `{"detail": "Este produto está com o cartão bloqueado."}`, e nada é criado
> * A cópia nasce na moeda do original. Duplicar produto em moeda diferente de `BRL` segue a mesma regra da [criação](https://docs.cakto.com.br/api-reference/products/create.md): sem a venda em moeda estrangeira habilitada na conta, a resposta é `400` no campo `currency`
> * Você pode modificar qualquer aspecto do produto duplicado após a criação
> * Se o produto tiver área de membros, ela também é copiada: configurações, imagens, cursos, módulos, aulas, materiais, certificados e planos de acesso. Alunos, matrículas e progresso **não** são copiados, e o endereço (`slug`) da área nasce vazio
> * O campo `member_area_copy` diz como ficou a área: `{"status": "done", "member_area_id": "..."}` quando ela já está completa na resposta, `{"status": "copying", ...}` quando a área é grande e o conteúdo é copiado em segundo plano (o dono do produto recebe e-mail e notificação no painel quando terminar), e `null` quando o produto não tem área de membros
> * Enquanto a área de membros do produto de origem ainda está sendo copiada de outra duplicação, a resposta é `409` com `{"detail": "A área de membros ainda está sendo copiada.", "code": "member_area_copying"}` e nada é criado. Tente de novo depois que a cópia terminar

> [!TIP]
>
> **Fluxo recomendado:**
>
> 1. Duplique o produto usando este endpoint
> 2. Imediatamente atualize o nome e outros detalhes específicos
> 3. Verifique e ajuste ofertas, preços e configurações conforme necessário
> 4. Teste o checkout antes de promover o produto


## OpenAPI

````yaml POST /public_api/products/{id}/duplicate/
openapi: 3.0.3
info:
  title: Cakto API
  version: 1.0.0
  description: Documentação da API pública do Cakto.
servers:
  - url: https://api.cakto.com.br
    description: Cakto API
security: []
paths:
  /public_api/products/{id}/duplicate/:
    post:
      tags:
        - products
      description: >-
        Public API for managing products, inherits from ProductRetrieveAPI and
        ProductAPI,

        customizes the schema generation and authentication/permission settings.
      operationId: products_duplicate_create
      parameters:
        - in: path
          name: id
          schema:
            type: string
          required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProductDuplicateSchema'
              examples:
                Successo:
                  value:
                    id: cd287b31-d4b7-4e94-858a-66e05ce2f4a2
                    member_area_copy:
                      status: copying
                      member_area_id: 5f0c2d1e-8a7b-4c3d-9e2f-1a2b3c4d5e6f
                    name: Product Name Example
                    image: https://example-image-url.com/image.png
                    description: Description example
                    price: 15
                    type: unique
                    contentDeliveries:
                      - cakto_v3
                      - telegram
                      - discord
                    emailAccessLink: null
                    salesPage: https://example-sales-page.com.br/product-page
                    status: active
                    paymentMethods:
                      - applepay
                      - boleto
                      - credit_card
                      - googlepay
                      - pix
                    category:
                      id: 0673d296-1802-45e0-bc93-112f7514dddb
                      name: Animais e Plantas
          description: Corpo da resposta status 200
        '400':
          content:
            application/json:
              schema:
                type: object
                properties:
                  detail:
                    type: string
              examples:
                CartaoBloqueado:
                  value:
                    detail: Este produto está com o cartão bloqueado.
                  summary: Produto com o pagamento por cartão bloqueado
          description: O produto não pode ser duplicado; nada é criado
        '401':
          description: Request não autenticado devido à ausência ou invalidez do token.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UnauthenticatedError'
              examples:
                Token ausente ou inválido:
                  $ref: '#/components/examples/UnauthenticatedErrorExample'
        '409':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MemberAreaCopyInProgress'
              examples:
                AreaDeMembrosEmCopia:
                  value:
                    detail: A área de membros ainda está sendo copiada.
                    code: member_area_copying
          description: >-
            A área de membros do produto de origem ainda está sendo copiada de
            outra duplicação; nada é criado
      security:
        - OAuth Token: []
components:
  schemas:
    ProductDuplicateSchema:
      allOf:
        - $ref: '#/components/schemas/Product'
        - type: object
          properties:
            member_area_copy:
              allOf:
                - $ref: '#/components/schemas/MemberAreaCopy'
              nullable: true
              description: >-
                Como ficou a cópia da área de membros; null quando o produto não
                tem área de membros
          required:
            - member_area_copy
    UnauthenticatedError:
      type: object
      properties:
        detail:
          type: string
    MemberAreaCopyInProgress:
      type: object
      properties:
        detail:
          type: string
        code:
          type: string
          enum:
            - member_area_copying
      required:
        - code
        - detail
    Product:
      type: object
      properties:
        id:
          type: string
          description: Identificador único do produto
          maxLength: 255
        name:
          type: string
          title: Nome
          description: Nome do produto
          maxLength: 255
        image:
          type: string
          format: uri
          readOnly: true
          nullable: true
          title: Imagem
          description: Imagem do produto
        description:
          type: string
          title: Descrição
          description: Descrição do produto
        price:
          type: number
          format: double
          description: Preço do produto
        currency:
          allOf:
            - $ref: '#/components/schemas/CurrencyEnum'
          title: Moeda
          description: |-
            Moeda do produto

            * `BRL` - Real
            * `EUR` - Euro
            * `MXN` - Peso Mexicano
            * `PEN` - Sol Peruano
            * `USD` - Dólar
            * `CLP` - Peso Chileno
            * `COP` - Peso Colombiano
            * `ARS` - Peso Argentino
            * `BOB` - Boliviano
            * `UYU` - Peso Uruguayo
        type:
          allOf:
            - $ref: '#/components/schemas/ProductType'
          title: Tipo
          description: |-
            Tipo de venda do produto, ex.: venda única, assinatura...

            * `unique` - Pagamento único
            * `subscription` - Assinatura recorrente
        contentDeliveries:
          type: array
          items:
            type: string
          readOnly: true
          description: Id dos métodos de entrega de conteúdo disponíveis
        emailAccessLink:
          type: string
          format: uri
          nullable: true
          title: Link de acesso
          description: Link a ser enviado por e-mail para acesso ao conteúdo após a compra
          maxLength: 2048
        salesPage:
          type: string
          format: uri
          nullable: true
          title: Página de vendas
          description: Link da página de vendas do produto
          maxLength: 2048
        status:
          allOf:
            - $ref: '#/components/schemas/ProductStatus'
          description: |-
            Status atual do produto

            * `active` - Ativo
            * `waiting_config` - Aguardando Configuração
            * `blocked` - Bloqueado
            * `deleted` - Deletado
        paymentMethods:
          type: array
          items:
            type: string
          readOnly: true
          description: Id dos métodos de pagamento disponíveis
        category:
          allOf:
            - $ref: '#/components/schemas/Category'
          readOnly: true
          description: Categoria do produto
      required:
        - category
        - contentDeliveries
        - description
        - image
        - name
        - paymentMethods
        - price
    MemberAreaCopy:
      type: object
      properties:
        status:
          type: string
          enum:
            - done
            - copying
          description: >-
            done: a área já está completa na resposta; copying: o conteúdo é
            copiado em segundo plano
        member_area_id:
          type: string
          format: uuid
          description: Id da área de membros do produto duplicado
      required:
        - member_area_id
        - status
    CurrencyEnum:
      enum:
        - BRL
        - EUR
        - MXN
        - PEN
        - USD
        - CLP
        - COP
        - ARS
        - BOB
        - UYU
      type: string
      description: |-
        * `BRL` - Real
        * `EUR` - Euro
        * `MXN` - Peso Mexicano
        * `PEN` - Sol Peruano
        * `USD` - Dólar
        * `CLP` - Peso Chileno
        * `COP` - Peso Colombiano
        * `ARS` - Peso Argentino
        * `BOB` - Boliviano
        * `UYU` - Peso Uruguayo
    ProductType:
      enum:
        - unique
        - subscription
      type: string
      description: |-
        * `unique` - Pagamento único
        * `subscription` - Assinatura recorrente
    ProductStatus:
      enum:
        - active
        - waiting_config
        - blocked
        - deleted
      type: string
      description: |-
        * `active` - Ativo
        * `waiting_config` - Aguardando Configuração
        * `blocked` - Bloqueado
        * `deleted` - Deletado
    Category:
      type: object
      properties:
        id:
          type: string
          maxLength: 255
        name:
          type: string
          maxLength: 255
      required:
        - name
  examples:
    UnauthenticatedErrorExample:
      summary: Token ausente ou inválido
      description: Token ausente ou inválido
      value:
        detail: As credenciais de autenticação não foram fornecidas.
  securitySchemes:
    OAuth Token:
      type: http
      scheme: bearer
      in: header
      name: Authorization
      description: >-
        Token de autenticação do tipo `Bearer {access_token}`, onde
        `{access_token}` é o token obtido no fluxo de
        [autenticação](/authentication).

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.