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

# Setting Keywords for a List

> This endpoint sets or updates keywords for a list.

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


## OpenAPI

````yaml PUT /api/v2/lists/{ID}/keywords
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}/keywords:
    put:
      tags:
        - Lists
      summary: Set Keywords for a List
      description: This endpoint sets or updates keywords for 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:
                keyword_names:
                  type: array
                  items:
                    type: string
                  description: Array of keyword names
              required:
                - keyword_names
            example:
              keyword_names:
                - TEST
                - KEYWORD
                - NAMES
      responses:
        '200':
          description: Keywords updated successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    example: Keywords changed
                  keyword_names:
                    type: array
                    items:
                      type: string
                    example:
                      - TEST
                      - KEYWORD
                      - NAMES
                required:
                  - status
                  - keyword_names
              example:
                status: Keywords changed
                keyword_names:
                  - TEST
                  - KEYWORD
                  - NAMES
      x-codeSamples:
        - lang: cURL
          label: cURL
          source: >-
            curl "https://app.tatango.com/api/v2/lists/<ID>/keywords" -d
            '{"keyword_names":["TEST","KEYWORD","NAMES"]}' -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'\nrequire 'uri'\n\nuri =
            URI.parse('https://app.tatango.com/api/v2/lists/<ID>/keywords')\nhttp
            = Net::HTTP.new(uri.host, uri.port)\nrequest =
            Net::HTTP::Put.new(uri.request_url)\nrequest.basic_auth("emailaddress@mydomain.com",
            "my_api_key")\nrequest.body({"keyword_names":["TEST","KEYWORD","NAMES"]})\nresponse
            = http.request(request)
        - lang: JavaScript
          label: JavaScript
          source: >-
            var request = new XMLHttpRequest();\nrequest.open('PUT',
            'https://app.tatango.com/api/v2/lists/<ID>/keywords',
            false);\nrequest.setRequestHeader('Content-Type',
            'application/json');\nrequest.setRequestHeader('Authorization',
            'Basic ' + btoa('emailaddress@mydomain.com:my_api_key'));\n\nvar
            data = JSON.stringify({\n  keyword_names: ['TEST', 'KEYWORD',
            'NAMES']\n});\n\nrequest.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.

````