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

# Restore

> Restaure uma lista excluída anteriormente na sua conta HubSpot. Esta operação permite recuperar listas que foram removidas, garantindo que todos os dados ou configurações associados sejam restabelecidos. Isso pode ser útil para recuperar listas que foram excluídas por engano ou que são mais necessárias para operações em andamento.

> **Supported products**

> **Required Scopes**


## OpenAPI

````yaml specs/2026-09/crm-lists-v2026-09.json PUT /crm/lists/2026-09/{listId}/restore
openapi: 3.0.1
info:
  title: CRM Lists
  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
servers:
  - url: https://api.hubapi.com
security: []
tags:
  - name: Basic
  - name: Batch
  - name: Search
paths:
  /crm/lists/2026-09/{listId}/restore:
    put:
      tags:
        - Basic
      summary: Restaurar
      description: >-
        Restaure uma lista excluída anteriormente na sua conta HubSpot. Esta
        operação permite recuperar listas que foram removidas, garantindo que
        todos os dados ou configurações associados sejam restabelecidos. Isso
        pode ser útil para recuperar listas que foram excluídas por engano ou
        que são mais necessárias para operações em andamento.
      operationId: put-/crm/lists/2026-09/{listId}/restore
      parameters:
        - name: listId
          in: path
          description: O identificador exclusivo da lista a ser restaurada.
          required: true
          style: simple
          explode: false
          schema:
            type: string
      responses:
        '204':
          description: No content
          content: {}
        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:
  responses:
    Error:
      description: An error occurred.
      content:
        '*/*':
          schema:
            $ref: '#/components/schemas/Error'
  schemas:
    Error:
      required:
        - category
        - correlationId
        - message
      type: object
      properties:
        category:
          type: string
          description: Uma string que indica a categoria do erro.
        context:
          type: object
          additionalProperties:
            type: array
            items:
              type: string
          description: >-
            Um objeto com contexto adicional sobre o erro, representado como um
            mapa de pares de chave-valor.
          example: >-
            {invalidPropertyName=[propertyValue], missingScopes=[scope1,
            scope2]}
        correlationId:
          type: string
          description: >-
            Um identificador exclusivo para a instância do erro, usado para fins
            de rastreamento e depuração.
          format: uuid
          example: aeb5f871-7f07-4993-9211-075dc63e7cbf
        errors:
          type: array
          description: >-
            Uma matriz de objetos ErrorDetail, cada um fornecendo informações
            adicionais sobre erros específicos que ocorreram.
          items:
            $ref: '#/components/schemas/ErrorDetail'
        links:
          type: object
          additionalProperties:
            type: string
          description: >-
            Um objeto com links relacionados, representado como um mapa de nomes
            de links para URLs.
        message:
          type: string
          description: Uma string que fornece uma descrição legível do erro.
          example: An error occurred
        subCategory:
          type: string
          description: >-
            Um objeto que representa uma classificação mais específica do erro
            dentro de sua categoria.
      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: >-
            Uma string que representa um código de erro específico que
            identifica o tipo de erro.
        context:
          type: object
          additionalProperties:
            type: array
            items:
              type: string
          description: >-
            Um objeto com contexto adicional sobre o erro, representado como um
            mapa de strings para matrizes de strings, que pode incluir
            parâmetros ou valores específicos relacionados ao erro.
          example: '{missingScopes=[scope1, scope2]}'
        in:
          type: string
          description: >-
            Uma string que indica o local onde o erro ocorreu, como 'query',
            'header' ou 'body'.
        message:
          type: string
          description: Uma string contendo uma descrição legível do erro.
        subCategory:
          type: string
          description: >-
            Um objeto que fornece categorização adicional do erro, que pode
            conter mais detalhes.
      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.
  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: ''

````