> ## 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.

# Remove Records from a List

> Remova os registros fornecidos da lista. Registros que não existem ou que não são membros da lista são ignorados.

Este ponto de extremidade só funciona para listas que têm "processingType" igual a "MANUAL" ou "SNAPSHOT".

> **Supported products**

> **Required Scopes**


## OpenAPI

````yaml specs/legacy/v3/crm-lists-v3.json PUT /crm/v3/lists/{listId}/memberships/remove
openapi: 3.0.1
info:
  title: CRM Lists
  description: CRUD operations to manage lists and list memberships
  version: v3
  x-hubspot-product-tier-requirements:
    marketing: FREE
    sales: FREE
    service: FREE
    cms: FREE
    commerce: FREE
    crmHub: FREE
    dataHub: FREE
  x-hubspot-related-documentation:
    - name: Lists Guide
      url: https://developers.hubspot.com/docs/guides/api/crm/lists/overview
servers:
  - url: https://api.hubapi.com
security: []
tags:
  - name: Basic
  - name: Batch
  - name: Search
paths:
  /crm/v3/lists/{listId}/memberships/remove:
    put:
      tags:
        - Basic
      summary: Remover registros de uma lista
      description: >-
        Remova os registros fornecidos da lista. Registros que não existem ou
        que não são membros da lista são ignorados.


        Este ponto de extremidade só funciona para listas que têm
        "processingType" igual a "MANUAL" ou "SNAPSHOT".
      operationId: >-
        put-/crm/v3/lists/{listId}/memberships/remove_/crm/v3/lists/{listId}/memberships/remove
      parameters:
        - name: listId
          in: path
          description: O **ID ILS** da lista "MANUAL" ou "SNAPSHOT".
          required: true
          style: simple
          explode: false
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              type: array
              items:
                type: string
        required: true
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MembershipsUpdateResponse'
        default:
          $ref: '#/components/responses/Error'
          description: ''
      security:
        - oauth2:
            - crm.lists.write
            - crm.segments.read
        - oauth2:
            - cms.membership.access_groups.write
            - crm.lists.read
        - oauth2:
            - crm.segments.read
            - crm.segments.write
        - oauth2:
            - crm.lists.read
            - crm.segments.write
        - oauth2:
            - crm.lists.read
            - crm.lists.write
        - oauth2:
            - cms.membership.access_groups.write
            - crm.segments.read
components:
  schemas:
    MembershipsUpdateResponse:
      required:
        - recordIdsMissing
        - recordIdsRemoved
        - recordsIdsAdded
      type: object
      properties:
        recordIdsMissing:
          type: array
          description: >-
            Os IDs dos registros que estavam faltando (por exemplo, não existiam
            no portal) e, portanto, não foram adicionados nem removidos.
          items:
            type: string
        recordIdsRemoved:
          type: array
          description: Os IDs dos registros que foram removidos da lista.
          items:
            type: string
        recordsIdsAdded:
          type: array
          items:
            type: string
      description: >-
        The IDs of the records that were `added`, `removed`, and/or found to be
        `missing` as a result of the 

        membership update request.
    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:
    oauth2:
      type: oauth2
      flows:
        authorizationCode:
          authorizationUrl: https://app.hubspot.com/oauth/authorize
          tokenUrl: https://api.hubapi.com/oauth/v1/token
          scopes:
            cms.membership.access_groups.write: ''
            crm.lists.read: ''
            crm.lists.write: ''
            crm.segments.read: ''
            crm.segments.write: ''

````