---
title: Store synonyms
slug: graph/api/store-synonyms
docTags: 
createdAt: 2026-08-28T18:28:55.472Z
---

{
  "id": "b8KTTqcUYk0L8hVI09JDB",
  "type": "api-oas-v2",
  "data": {
    "method": "PUT",
    "url": "https://cg.optimizely.com/resources/synonyms",
    "servers": [
      {
        "url": "https://cg.optimizely.com/resources/synonyms"
      }
    ],
    "name": "Store synonyms",
    "description": "<p>When you write a query, you can use synonyms to expand the keywords to get results that users otherwise may not have found.\nThis reduces the problem of getting too few or no results, leading to fewer chances of conversions or even search abandonment.\nFor example, if you search for \"H2O\", you mat want to find results that contain \"water\".\nThis happens when you store synonyms in Optimizely Graph and enable them per field in your query. Otherwise, many relevant results may not be retrieved.</p>",
    "contentType": "text/plain",
    "request": {
      "pathParameters": [],
      "headerParameters": [],
      "queryParameters": [
        {
          "kind": "optional",
          "name": "language_routing",
          "type": "string",
          "description": ""
        },
        {
          "kind": "optional",
          "name": "source_routing",
          "type": "string",
          "description": ""
        },
        {
          "kind": "optional",
          "name": "synonym_slot",
          "type": "string",
          "description": "",
          "default": "one",
          "enum": [
            "one",
            "two"
          ]
        }
      ],
      "bodyDataParameters": [],
      "formDataParameters": [],
      "oAuthParameters": [
        {
          "id": "epi-hmac",
          "name": "Authorization",
          "kind": "optional",
          "type": "apiKey",
          "description": "<p>HMAC authentication (<code>epi-hmac xxx</code>)</p>",
          "in": "header"
        },
        {
          "id": "Basic",
          "name": "Basic",
          "kind": "optional",
          "type": "http",
          "description": "HMAC credentials",
          "scheme": "basic"
        },
        {
          "id": "Bearer",
          "name": "Bearer",
          "kind": "optional",
          "type": "http",
          "description": "JWT token",
          "scheme": "bearer"
        }
      ],
      "cookieParameters": []
    },
    "responses": [
      {
        "statusCode": "204",
        "description": "No content",
        "jsonExample": "",
        "isExpanded": true
      }
    ],
    "hasXCodeSamples": false,
    "examples": {
      "languages": [
        {
          "id": "JN52lP3VK2P5EH1kZ-HYb",
          "language": "curl",
          "label": "cURL",
          "code": "curl --request PUT \\\n     --url 'https://cg.optimizely.com/resources/synonyms?synonym_slot=one' \\\n     --header 'accept: application/json'"
        },
        {
          "id": "8n0FkQ9Zc9KtIklnHYfCy",
          "language": "javascript",
          "label": "javascript",
          "code": "var myHeaders = new Headers();\nmyHeaders.append(\"accept\", \"application/json\");\nmyHeaders.append(\"content-type\", \"text/plain\");\n\nvar requestOptions = {\n   method: 'PUT',\n   headers: myHeaders,\n   redirect: 'follow'\n};\n\nfetch(\"https://cg.optimizely.com/resources/synonyms?synonym_slot=one\", requestOptions)\n   .then(response => response.text())\n   .then(result => console.log(result))\n   .catch(error => console.log('error', error));"
        },
        {
          "id": "R3MTbMqwF_yU6KK4GddSl",
          "language": "ruby",
          "label": "Ruby",
          "code": "require \"uri\"\nrequire \"net/http\"\n\nurl = URI(\"https://cg.optimizely.com/resources/synonyms?synonym_slot=one\")\n\nhttps = Net::HTTP.new(url.host, url.port)\nhttps.use_ssl = true\n\nrequest = Net::HTTP::Put.new(url)\nrequest[\"accept\"] = \"application/json\"\nrequest[\"content-type\"] = \"text/plain\"\n\nresponse = https.request(request)\nputs response.read_body\n"
        },
        {
          "id": "1inMwwMFyP7Xby_wQJKUd",
          "language": "python",
          "label": "Python",
          "code": "import requests\n\nurl = \"https://cg.optimizely.com/resources/synonyms?synonym_slot=one\"\n\npayload = {}\nheaders = {\n   'accept': 'application/json',\n   'content-type': 'text/plain'\n}\n\nresponse = requests.request(\"PUT\", url, headers=headers, data=payload)\n\nprint(response.text)\n"
        }
      ],
      "selectedLanguageId": "JN52lP3VK2P5EH1kZ-HYb"
    },
    "results": {
      "languages": [
        {
          "id": "response-0-204",
          "language": "204",
          "code": "// No content\n"
        }
      ],
      "selectedLanguageId": "response-0-204"
    }
  },
  "children": [
    {
      "text": ""
    }
  ]
}