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

# 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: 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}/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: >-
        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.

````