---
updatedAt: 2026-07-02T13:23:40.000Z
agentTools:
  projectIndex: https://docs.mesh.complyadvantage.com/llms.txt
---

# Delete a risk word

Removes a single risk word from a custom list of type `RISK_WORD`, identified by its identifier. The risk word will be archived asynchronously and removed from search later.


You need "Access to custom lists for customer screening" enabled and the "Create, update, and delete custom lists and their entities, and download entities" permission to use this endpoint.

# OpenAPI definition

```json
{
  "components": {
    "schemas": {
      "customlist_ProblemDetailErrorResponse": {
        "additionalProperties": true,
        "properties": {
          "detail": {
            "nullable": true,
            "type": "string"
          },
          "identifier": {
            "format": "uuid",
            "type": "string"
          },
          "instance": {
            "format": "uri",
            "nullable": true,
            "type": "string"
          },
          "status": {
            "format": "int32",
            "nullable": true,
            "type": "integer"
          },
          "timestamp": {
            "format": "date-time",
            "type": "string"
          },
          "title": {
            "nullable": true,
            "type": "string"
          },
          "type": {
            "format": "uri",
            "nullable": true,
            "type": "string"
          }
        },
        "required": [
          "identifier",
          "timestamp"
        ],
        "type": "object"
      }
    },
    "securitySchemes": {
      "BearerAuth": {
        "description": "HTTP Bearer Token Authentication",
        "scheme": "bearer",
        "type": "http"
      }
    }
  },
  "info": {
    "title": "Mesh API",
    "version": "v2.0"
  },
  "openapi": "3.0.3",
  "paths": {
    "/v2/custom-lists/{custom_list_id}/risk-word/{id}": {
      "delete": {
        "description": "Removes a single risk word from a custom list of type `RISK_WORD`, identified by its identifier. The risk word will be archived asynchronously and removed from search later.\n\n\nYou need \"Access to custom lists for customer screening\" enabled and the \"Create, update, and delete custom lists and their entities, and download entities\" permission to use this endpoint.",
        "operationId": "customListAPIArchiveRiskWordFromList",
        "parameters": [
          {
            "description": "The identifier of the custom list containing the risk word to be deleted.",
            "example": "00000000-0000-0000-0000-000000000000",
            "in": "path",
            "name": "custom_list_id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          },
          {
            "description": "The identifier of the risk word to delete",
            "example": "risk_word_1",
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "202": {
            "description": "The requested risk word will be archived and removed from search as soon as possible"
          },
          "400": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/customlist_ProblemDetailErrorResponse"
                }
              }
            },
            "description": "The custom list id is expected to be a UUID, or the custom list is not of type RISK_WORD"
          },
          "404": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/customlist_ProblemDetailErrorResponse"
                }
              }
            },
            "description": "The requested risk word could not be found."
          }
        },
        "summary": "Delete a risk word",
        "tags": [
          "Custom Lists"
        ]
      }
    }
  },
  "security": [
    {
      "BearerAuth": []
    }
  ],
  "servers": [
    {
      "description": "ComplyAdvantage Mesh API",
      "url": "https://api.mesh.complyadvantage.com"
    }
  ],
  "tags": [
    {
      "name": "Custom Lists"
    }
  ]
}
```