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

# Atualizar card de CRM

> Atualização parcial do card. Apenas os campos enviados são modificados. Enviar `columnId` move o card para outra etapa do funil.



## OpenAPI

````yaml https://api.jurichat.com/docs/client/openapi.json patch /funnel-column-card/{id}
openapi: 3.1.0
info:
  title: JuriChat API — Documentação para Integradores
  description: ''
  version: 1.0.0
servers:
  - url: https://api.jurichat.com
    description: Production server
security:
  - apiKeyAuth: []
tags: []
paths:
  /funnel-column-card/{id}:
    patch:
      tags:
        - CRM
      summary: Atualizar card de CRM
      description: >-
        Atualização parcial do card. Apenas os campos enviados são modificados.
        Enviar `columnId` move o card para outra etapa do funil.
      parameters:
        - schema:
            type: string
            pattern: ^[cC][^\s-]{8,}$
          in: path
          name: id
          required: true
          description: ID do card de CRM.
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                channel:
                  type: string
                  description: Novo canal de origem do lead. Opcional.
                columnId:
                  type: string
                  pattern: ^[cC][^\s-]{8,}$
                  description: >-
                    ID da nova etapa do funil. Mover o card para outra etapa
                    quando enviado.
                userId:
                  type: string
                  pattern: ^[cC][^\s-]{8,}$
                  description: ID do novo usuário responsável pelo card. Opcional.
                personId:
                  type: string
                  pattern: ^[cC][^\s-]{8,}$
                  description: ID do novo contato vinculado ao card. Opcional.
                customFields:
                  type: array
                  items:
                    type: object
                    properties:
                      id:
                        type: string
                        pattern: ^[cC][^\s-]{8,}$
                        description: ID do campo personalizado.
                      name:
                        type: string
                        description: Nome do campo personalizado.
                      type:
                        type: string
                        description: Tipo do campo (texto, data, seleção etc.).
                      options:
                        description: Opções do campo para tipos de seleção.
                      value:
                        description: Novo valor do campo personalizado.
                    required:
                      - id
                    additionalProperties: false
                  description: >-
                    Campos personalizados a atualizar. Substitui os valores dos
                    campos informados.
                tags:
                  type: array
                  items:
                    type: string
                  description: IDs das tags. Substitui todas as tags atuais quando enviado.
                legalAreaId:
                  type: string
                  pattern: ^[cC][^\s-]{8,}$
                  nullable: true
                  description: >-
                    ID da área jurídica a vincular à conversa do contato neste
                    card. Envie `null` para desvincular.
                createdAt:
                  type: string
                  format: date-time
                  description: Data de criação personalizada. Opcional.
                updatedAt:
                  type: string
                  format: date-time
                  description: Data de atualização personalizada. Opcional.
                targetCardId:
                  type: string
                  pattern: ^[cC][^\s-]{8,}$
                  description: ID do card usado como referência para posicionamento.
                placement:
                  type: string
                  enum:
                    - before
                    - after
                    - top
                  description: Posição do card em relação ao card de referência.
              additionalProperties: false
      responses:
        '200':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  columnChangedAt:
                    type: string
                    format: date-time
                    description: Data e hora em que o card foi movido para a etapa atual.
                  id:
                    type: string
                    description: ID do card.
                  channel:
                    type: string
                    nullable: true
                    description: Canal de origem do lead. Null se não informado.
                  columnId:
                    type: string
                    pattern: ^[cC][^\s-]{8,}$
                    description: ID da etapa atual do card.
                  userId:
                    type: string
                    pattern: ^[cC][^\s-]{8,}$
                    description: ID do usuário responsável pelo card.
                  personId:
                    type: string
                    pattern: ^[cC][^\s-]{8,}$
                    description: ID do contato vinculado ao card.
                  customFields:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          description: ID do campo personalizado.
                        value:
                          description: Valor atual do campo personalizado.
                      required:
                        - id
                      additionalProperties: false
                    description: Campos personalizados do card com valores atualizados.
                  tags:
                    type: array
                    items:
                      type: string
                    description: IDs das tags associadas ao card.
                  createdAt:
                    type: string
                    format: date-time
                    description: Data e hora de criação do card.
                  updatedAt:
                    type: string
                    format: date-time
                    description: Data e hora da última atualização do card.
                required:
                  - columnChangedAt
                  - id
                  - channel
                  - columnId
                  - personId
                  - createdAt
                  - updatedAt
                additionalProperties: false
        '400':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                  statusCode:
                    type: number
                  details: {}
                required:
                  - message
                  - statusCode
                additionalProperties: false
        '404':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                  statusCode:
                    type: number
                  details: {}
                required:
                  - message
                  - statusCode
                additionalProperties: false
      security:
        - apiKeyAuth: []
components:
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: x-jurichat-api-key
      description: >-
        Chave de API do escritório (criada no painel). Envie o valor no header
        x-jurichat-api-key.

````