> ## Documentation Index
> Fetch the complete documentation index at: https://developers.momogood.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: momoGood Messaging API v2
  description: >-
    The platform management API for momoGood Messaging (formerly the Tatango v2
    API). Manage lists, subscribers, custom fields, tags, webhooks, shortcodes,
    MOMT reports, and scheduled broadcasts from a single REST surface.
  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
                        - 'null'
                      description: >-
                        Email to send email digest to. Leave blank if you dont
                        want to receive
                    email_subscribe:
                      type:
                        - string
                        - 'null'
                      description: >-
                        Email to send subscribe notifications to. Leave blank if
                        you dont want to receive
                    email_unsubscribe:
                      type:
                        - string
                        - 'null'
                      description: >-
                        Email to send unsubscribe notifications to. Leave blank
                        if you dont want to receive
              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: >-
        The momoGood Messaging API v2 authenticates 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.

````