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

# Updating a List

> This endpoint updates a list.

## Request URL

```http theme={null}
PUT https://app.tatango.com/api/v2/lists/<ID>
```

<Note>
  The following settings cannot be modified via the API:

  * API Confirmation Resend Block Timeout
  * Resubscribers
</Note>


## OpenAPI

````yaml PUT /api/v2/lists/{ID}
openapi: 3.1.0
info:
  title: Tatango Legacy v2 API
  description: Tatango legacy v2 API endpoints for existing integrations.
  version: 2.0.0
servers:
  - url: https://app.tatango.com
security:
  - basicAuth: []
paths:
  /api/v2/lists/{ID}:
    put:
      tags:
        - Lists
      summary: Updating a List
      description: This endpoint updates a list.
      parameters:
        - name: ID
          in: path
          description: The ID of the list to change.
          required: true
          schema:
            type: integer
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                list:
                  type: object
                  properties:
                    name:
                      type: string
                      description: List name
                    message_yes:
                      type: string
                      description: API Opt-In Confirmation Request
                    message_help:
                      type: string
                      description: HELP Response
                    message_stop:
                      type: string
                      description: STOP Response
                    message_reply:
                      type: string
                      description: REPLY Response
                    message_already_subscribed:
                      type: string
                      description: Already Subscribed Response
                    first_optin_message:
                      type: string
                      description: First Opt In Message
                    second_optin_message:
                      type: string
                      description: Second Opt In Message
                    email_digest:
                      type: string
                      description: >-
                        Email to send email digest to. Leave blank if you dont
                        want to receive
                      nullable: true
                    email_subscribe:
                      type: string
                      description: >-
                        Email to send subscribe notifications to. Leave blank if
                        you dont want to receive
                      nullable: true
                    email_unsubscribe:
                      type: string
                      description: >-
                        Email to send unsubscribe notifications to. Leave blank
                        if you dont want to receive
                      nullable: true
              required:
                - list
            example:
              list:
                name: Name
                message_yes: Reply YES to confirm subscription
                message_help: Help message
                message_stop: Stop message
                message_reply: Reply message
                message_already_subscribed: Already subscribed message
                first_optin_message: First opt-in message
                second_optin_message: Second opt-in message
                email_digest: email@example.com
                email_subscribe: subscribe@example.com
                email_unsubscribe: unsubscribe@example.com
      x-codeSamples:
        - lang: cURL
          label: cURL
          source: >-
            curl "https://app.tatango.com/api/v2/lists/" -d
            '{"list":{"name":"Name"}}' -X PUT \
              -H "Accept: application/json" \
              -H "Content-Type: application/json" \
              -u emailaddress@mydomain.com:my_api_key \
              -H "Host: example.org" \
              -H "Cookie: "
        - lang: Ruby
          label: Ruby
          source: |-
            require 'net/http'
            require 'uri'

            uri = URI.parse('https://app.tatango.com/api/v2/lists/ID')
            http = Net::HTTP.new(uri.host, uri.port)
            request = Net::HTTP::Put.new(uri.request_url)
            request.basic_auth("emailaddress@mydomain.com", "my_api_key")
            request.body({"list":{"name":"Name"}})
            response = http.request(request)
        - lang: JavaScript
          label: JavaScript
          source: >-
            var request = new XMLHttpRequest();

            request.open("PUT", "https://app.tatango.com/api/v2/lists/", false);

            request.setRequestHeader("Content-Type", "application/json");

            request.setRequestHeader("Authorization", "Basic " +
            btoa("emailaddress@mydomain.com:my_api_key"));

            var data = JSON.stringify({ list: { name: "Name" } });

            request.send(data);
components:
  securitySchemes:
    basicAuth:
      type: http
      scheme: basic
      description: >-
        Tatango authenticates API requests by validating an API key passed via
        HTTP Basic Authentication. Use your login email as the username and your
        API key as the password.

````