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

# Migrate CRM card views

> Troca um cartão de CRM antigo por um cartão de aplicativo nas exibições. Consulte a documentação "Migrar um cartão de CRM antigo para um cartão de aplicativo" para obter mais informações

> **Supported products**


## OpenAPI

````yaml specs/2026-09/crm-public-app-crm-cards-v2026-09.json POST /crm/extensions/cards-dev/2026-09/{appId}/views/migrate
openapi: 3.0.1
info:
  title: Cartões de CRM do aplicativo público
  description: Basepom for all HubSpot Projects
  version: 2026-09
  x-hubspot-product-tier-requirements:
    marketing: FREE
    sales: FREE
    service: FREE
    cms: FREE
    commerce: FREE
    crmHub: FREE
    dataHub: FREE
  x-hubspot-api-use-case: >-
    Adicione um cartão personalizado aos registros de contato para exibir dados
    do seu software externo de rastreamento de bugs.
  x-hubspot-introduction: >-
    Crie cartões personalizados para dados de sistemas externos em registros do
    CRM. Requer um aplicativo público. Esses cartões do CRM são diferentes das
    extensões de UI que você pode criar com projetos.
servers:
  - url: https://api.hubapi.com
security: []
tags:
  - name: Advanced
  - name: Basic
paths:
  /crm/extensions/cards-dev/2026-09/{appId}/views/migrate:
    post:
      tags:
        - Advanced
      summary: Migrar exibições de cartão
      description: >-
        Troca um cartão de CRM antigo por um cartão de aplicativo nas exibições.
        Consulte a documentação "Migrar um cartão de CRM antigo para um cartão
        de aplicativo" para obter mais informações
      operationId: >-
        post-/crm/extensions/cards-dev/2026-09/{appId}/views/migrate_/crm/v3/extensions/cards-dev/{appId}/views/migrate
      parameters:
        - name: appId
          in: path
          description: >-
            O identificador exclusivo do aplicativo para o qual as visualizações
            estão sendo migradas.
          required: true
          style: simple
          explode: false
          schema:
            type: integer
            format: int32
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CardMigrateViewsRequest'
        required: true
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CardMigrateViewsResponse'
        default:
          $ref: '#/components/responses/Error'
          description: ''
      security:
        - developer_hapikey: []
components:
  schemas:
    CardMigrateViewsRequest:
      required:
        - allowDuplicateAppCardIds
        - appCardId
        - legacyCrmCardId
      type: object
      properties:
        allowDuplicateAppCardIds:
          type: boolean
          description: >-
            Um sinalizador booleano que indica se IDs de cartões de aplicativo
            duplicados são permitidos durante o processo de migração.
        appCardId:
          type: integer
          description: >-
            O identificador exclusivo para o novo cartão de aplicativo para o
            qual as visualizações serão migradas. Este é um número inteiro no
            formato int64.
          format: int64
        helpdeskAppCardId:
          type: integer
          description: >-
            O identificador exclusivo para o cartão do aplicativo de help desk,
            se aplicável. Este é um número inteiro no formato int64.
          format: int64
        legacyCrmCardId:
          type: integer
          description: >-
            O identificador exclusivo para o cartão do CRM legado. Este é um
            número inteiro no formato int64.
          format: int64
        tabAppCardId:
          type: integer
          format: int64
    CardMigrateViewsResponse:
      required:
        - message
      type: object
      properties:
        endedAt:
          type: integer
          description: A data/hora em que a migração terminou.
          format: int64
        message:
          type: string
          description: >-
            Uma mensagem legível por humanos que descreve o progresso da
            migração.
        remainingPortalCount:
          type: integer
          description: >-
            O número de portais que ainda precisam ser trocados do cartão de CRM
            antigo para o cartão de aplicativo
          format: int64
        startedAt:
          type: integer
          description: A data e a hora em que a migração começou.
          format: int64
        totalPortalCount:
          type: integer
          description: O número total de portais que têm acesso ao cartão de CRM antigo
          format: int64
    Error:
      required:
        - category
        - correlationId
        - message
      type: object
      properties:
        category:
          type: string
          description: A categoria de erro
        context:
          type: object
          additionalProperties:
            type: array
            items:
              type: string
          description: Contexto sobre a condição do erro
          example: >-
            {invalidPropertyName=[propertyValue], missingScopes=[scope1,
            scope2]}
        correlationId:
          type: string
          description: >-
            Um identificador exclusivo para a solicitação. Inclua este valor em
            relatórios de erro ou tickets de suporte
          format: uuid
          example: aeb5f871-7f07-4993-9211-075dc63e7cbf
        errors:
          type: array
          description: mais informações sobre o erro
          items:
            $ref: '#/components/schemas/ErrorDetail'
        links:
          type: object
          additionalProperties:
            type: string
          description: >-
            Um mapa de nomes de links para URIs associados que contêm
            documentação sobre o erro ou as etapas de correção recomendadas
        message:
          type: string
          description: >-
            Uma mensagem legível por humanos que descreve o erro, juntamente com
            as etapas de correção, quando apropriado
          example: An error occurred
        subCategory:
          type: string
          description: >-
            Uma categoria específica que contém mais detalhes específicos sobre
            o erro
      description: >-
        Representa uma resposta de erro retornada pela API quando uma operação
        falha. Este componente é usado em vários endpoints para fornecer
        informações detalhadas sobre o erro encontrado.
      example:
        message: Invalid input (details will vary based on the error)
        correlationId: aeb5f871-7f07-4993-9211-075dc63e7cbf
        category: VALIDATION_ERROR
        links:
          knowledge-base: https://www.hubspot.com/products/service/knowledge-base
    ErrorDetail:
      required:
        - message
      type: object
      properties:
        code:
          type: string
          description: O código de status associado ao detalhe do erro
        context:
          type: object
          additionalProperties:
            type: array
            items:
              type: string
          description: Contexto sobre a condição do erro
          example: '{missingScopes=[scope1, scope2]}'
        in:
          type: string
          description: O nome do campo ou parâmetro no qual o erro foi encontrado.
        message:
          type: string
          description: >-
            Uma mensagem legível por humanos que descreve o erro, juntamente com
            as etapas de correção, quando apropriado
        subCategory:
          type: string
          description: >-
            Uma categoria específica que contém mais detalhes específicos sobre
            o erro
      description: >-
        Representa informações detalhadas sobre um erro ocorrido na API. Este
        componente é usado para fornecer contexto e detalhes adicionais sobre os
        erros, geralmente como parte de uma resposta de erro.
  responses:
    Error:
      description: An error occurred.
      content:
        '*/*':
          schema:
            $ref: '#/components/schemas/Error'
  securitySchemes:
    developer_hapikey:
      type: apiKey
      name: hapikey
      in: query

````