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

# Rename a list

> Renames a list owned by the authenticated user.



## OpenAPI

````yaml /v2-openapi.json put /lists/{id}
openapi: 3.0.0
info:
  title: Seamless API
  description: >-
    Search and research Seamless.AI contacts and companies, and work with the
    records saved to your organization. Authentication, rate limits, and credits
    are covered at https://docs.seamless.ai.


    Public API v2 is in beta. Every v2 endpoint returns 403 until Seamless
    enables v2 for your organization; contact your Account Executive or support
    for access.


    [Privacy Policy](https://seamless.ai/policies/privacy-policy)
  version: 1.0.0
  termsOfService: https://seamless.ai/policies/terms-of-use
servers:
  - url: https://api.seamless.ai/api/client/v2
    description: Seamless API
security: []
tags: []
paths:
  /lists/{id}:
    put:
      tags:
        - Lists
      summary: Rename a list
      description: Renames a list owned by the authenticated user.
      operationId: updateList
      parameters:
        - in: path
          name: id
          required: true
          description: Unique identifier of the list
          schema:
            type: integer
            example: 123
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - name
              properties:
                name:
                  type: string
                  description: New display name for the list. Stored as sent.
                  example: Q4 Prospects
      responses:
        '200':
          description: The updated list.
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: true
                  data:
                    type: object
                    properties:
                      listId:
                        type: string
                        description: Unique identifier of the list.
                        example: '10001'
                      name:
                        type: string
                        description: Display name of the list.
                        example: Q3 Prospects
                      createdAt:
                        type: string
                        format: date-time
                        description: When the list was created.
                      updatedAt:
                        type: string
                        format: date-time
                        description: When the list was last updated.
        '400':
          description: Validation error
          content:
            application/json:
              schema:
                type: object
                required:
                  - msg
                properties:
                  msg:
                    description: A human readable error message
                    type: string
                  code:
                    description: Machine-readable error code, when one applies
                    type: string
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                type: object
                required:
                  - msg
                properties:
                  msg:
                    description: A human readable error message
                    type: string
                  code:
                    description: Machine-readable error code, when one applies
                    type: string
        '403':
          description: >-
            The connection lacks the required scope, or the organization does
            not have access to this feature
          content:
            application/json:
              schema:
                type: object
                required:
                  - msg
                properties:
                  msg:
                    description: A human readable error message
                    type: string
                  code:
                    description: Machine-readable error code, when one applies
                    type: string
        '404':
          description: >-
            The authenticated user has no list with this ID (code
            `tagNotFound`).
          content:
            application/json:
              schema:
                type: object
                required:
                  - msg
                properties:
                  msg:
                    description: A human readable error message
                    type: string
                  code:
                    description: Machine-readable error code, when one applies
                    type: string
        '422':
          description: Public API access is not enabled for this user
          content:
            application/json:
              schema:
                type: object
                required:
                  - msg
                properties:
                  msg:
                    description: A human readable error message
                    type: string
                  code:
                    description: Machine-readable error code, when one applies
                    type: string
        '500':
          description: Unexpected error
          content:
            application/json:
              schema:
                type: object
                required:
                  - msg
                properties:
                  msg:
                    description: A human readable error message
                    type: string
                  code:
                    description: Machine-readable error code, when one applies
                    type: string
      security:
        - OAuth2:
            - publicAPI.v2.all
        - ApiKeyAuth: []
components:
  securitySchemes:
    OAuth2:
      type: oauth2
      flows:
        authorizationCode:
          authorizationUrl: https://login.seamless.ai/oauth/authorize
          tokenUrl: https://api.seamless.ai/api/client/v2/oauth/accessToken
          scopes:
            publicAPI.v2.all: Public API v2
    ApiKeyAuth:
      type: apiKey
      name: Token
      in: header
      description: API key passed via the Token header.

````

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