--- updatedAt: 2026-08-18T09:17:24.000Z agentTools: projectIndex: https://docs.mesh.complyadvantage.com/llms.txt --- # Update a Lookup List Mapping Updates a Lookup List Mapping by creating a new record with the updated values, and marking the old one as INACTIVE, so that it is not used anymore, but it's kept for audit purposes. You need the "View lookup lists" and "Create and update lookup lists" permissions to use this endpoint. # OpenAPI definition ```json { "components": { "schemas": { "mes_LookupListMappingPatchRequestBody": { "properties": { "lookup_list_identifier": { "format": "uuid", "nullable": true, "type": "string" }, "output_fields": { "items": { "$ref": "#/components/schemas/mes_OutputField" }, "nullable": true, "type": "array" }, "source_fields": { "items": { "$ref": "#/components/schemas/mes_SourceField" }, "nullable": true, "type": "array" } }, "type": "object" }, "mes_LookupListMappingResponse": { "properties": { "created_at": { "format": "date-time", "type": "string" }, "created_by": { "format": "uuid", "type": "string" }, "identifier": { "format": "uuid", "type": "string" }, "lookup_list_identifier": { "format": "uuid", "type": "string" }, "output_fields": { "items": { "$ref": "#/components/schemas/mes_OutputField" }, "type": "array" }, "source_fields": { "items": { "$ref": "#/components/schemas/mes_SourceField" }, "type": "array" }, "status": { "enum": [ "ACTIVE", "INACTIVE" ], "type": "string" }, "updated_at": { "format": "date-time", "nullable": true, "type": "string" }, "updated_by": { "format": "uuid", "nullable": true, "type": "string" } }, "required": [ "created_at", "created_by", "identifier", "lookup_list_identifier", "output_fields", "source_fields", "status" ], "type": "object" }, "mes_OutputField": { "properties": { "field_key": { "type": "string" }, "lookup_list_column_name": { "type": "string" } }, "required": [ "field_key", "lookup_list_column_name" ], "type": "object" }, "mes_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" }, "mes_SourceField": { "properties": { "field_key": { "type": "string" }, "lookup_list_column_name": { "type": "string" } }, "required": [ "field_key", "lookup_list_column_name" ], "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": { "/v3/enrichment/transaction/lookup-list-mappings/{identifier}": { "patch": { "description": "Updates a Lookup List Mapping by creating a new record with the updated values, and marking the old one as INACTIVE, so that it is not used anymore, but it's kept for audit purposes.\n\n\nYou need the \"View lookup lists\" and \"Create and update lookup lists\" permissions to use this endpoint.", "operationId": "meshEnrichmentServiceUpdateLookupListMapping", "parameters": [ { "description": "The identifier of the lookup list mapping to update.", "example": "00000000-0000-0000-0000-000000000000", "in": "path", "name": "identifier", "required": true, "schema": { "format": "uuid", "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/mes_LookupListMappingPatchRequestBody" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/mes_LookupListMappingResponse" } } }, "description": "Lookup List Mapping updated" }, "400": { "content": { "application/problem+json": { "examples": { "Invalid number of output fields": { "description": "Invalid number of output fields", "value": { "detail": "Output fields array must contain exactly 1 element", "identifier": "019a6ffb-f7f1-7025-8ad7-f65076ccdbe6", "instance": "https://api.example.com/v3/enrichment/transaction/lookup-list-mappings", "status": 400, "timestamp": "2025-11-10T22:56:15.345Z", "title": "MIN_1_AND_MAX_1_OUTPUT_FIELDS", "type": "about:blank" } }, "Invalid number of source fields": { "description": "Invalid number of source fields", "value": { "detail": "Source fields array must contain exactly 1 element", "identifier": "019a6ffb-f7f1-7025-8ad7-f65076ccdbe5", "instance": "https://api.example.com/v3/enrichment/transaction/lookup-list-mappings", "status": 400, "timestamp": "2025-11-10T22:56:15.345Z", "title": "MIN_1_AND_MAX_1_SOURCE_FIELDS", "type": "about:blank" } }, "Invalid source field": { "description": "Invalid source field", "value": { "detail": "Source field key is not a valid block ID or transaction path", "identifier": "019a6ffb-f7f1-7025-8ad7-f65076ccdbe4", "instance": "https://api.example.com/v3/enrichment/transaction/lookup-list-mappings", "status": 400, "timestamp": "2025-11-10T22:56:15.345Z", "title": "SOURCE_FIELD_DOESNT_BELONG_TO_AVAILABLE_SOURCE_FIELDS", "type": "about:blank" } }, "Invalid transaction_output_field_key format": { "description": "Invalid transaction_output_field_key format", "value": { "detail": "Output field key has invalid format", "identifier": "019a6ffb-f7f1-7025-8ad7-f65076ccdbe3", "instance": "https://api.example.com/v3/enrichment/transaction/lookup-list-mappings", "status": 400, "timestamp": "2025-11-10T22:56:15.345Z", "title": "TRANSACTION_OUTPUT_FIELD_KEY_INVALID_FORMAT", "type": "about:blank" } }, "Lookup list identifier cannot be changed": { "description": "Lookup list identifier cannot be changed", "value": { "detail": "Lookup list identifier cannot be changed in an update operation", "identifier": "019a6ffb-f7f1-7025-8ad7-f65076ccdbea", "instance": "https://api.example.com/v3/enrichment/transaction/lookup-list-mappings/00000000-0000-0000-0000-000000000000", "status": 400, "timestamp": "2025-11-10T22:56:15.345Z", "title": "LOOKUP_LIST_IDENTIFIER_CANNOT_BE_CHANGED", "type": "about:blank" } }, "Lookup list identifier not found": { "description": "Lookup list identifier not found", "value": { "detail": "A lookup list with the identifier could not be found.", "identifier": "019a6ffb-f7f1-7025-8ad7-f65076ccdbe7", "instance": "https://api.example.com/v3/enrichment/transaction/lookup-list-mappings", "status": 400, "timestamp": "2025-11-10T22:56:15.345Z", "title": "LOOKUP_LIST_IDENTIFIER_MUST_EXIST", "type": "about:blank" } }, "No changes detected": { "description": "No changes detected", "value": { "detail": "No changes detected. At least one field must be modified.", "identifier": "019a6ffb-f7f1-7025-8ad7-f65076ccdbe1", "instance": "https://api.example.com/v3/enrichment/transaction/lookup-list-mappings/00000000-0000-0000-0000-000000000000", "status": 400, "timestamp": "2025-11-10T22:56:15.345Z", "title": "NOTHING_TO_UPDATE", "type": "about:blank" } }, "Output field schema mismatch": { "description": "Output field schema mismatch", "value": { "detail": "Output field does not match output schema", "identifier": "019a6ffb-f7f1-7025-8ad7-f65076ccdbe9", "instance": "https://api.example.com/v3/enrichment/transaction/lookup-list-mappings", "status": 400, "timestamp": "2025-11-10T22:56:15.345Z", "title": "OUTPUT_FIELD_LOOKUP_LIST_COLUMN_NAME_MUST_MATCH_OUTPUT_FROM_SCHEMA", "type": "about:blank" } }, "Source field schema mismatch": { "description": "Source field schema mismatch", "value": { "detail": "Source field does not match input schema", "identifier": "019a6ffb-f7f1-7025-8ad7-f65076ccdbe8", "instance": "https://api.example.com/v3/enrichment/transaction/lookup-list-mappings", "status": 400, "timestamp": "2025-11-10T22:56:15.345Z", "title": "SOURCE_FIELD_LOOKUP_LIST_COLUMN_NAME_MUST_MATCH_INPUT_FROM_SCHEMA", "type": "about:blank" } }, "Source field type mismatch": { "description": "Source field type mismatch", "value": { "detail": "Source field type does not match the schema type", "identifier": "019a6ffb-f7f1-7025-8ad7-f65076ccdbe0", "instance": "https://api.example.com/v3/enrichment/transaction/lookup-list-mappings", "status": 400, "timestamp": "2025-11-10T22:56:15.345Z", "title": "EXISTING_SOURCE_FIELD_MUST_MATCH_SCHEMA_TYPE", "type": "about:blank" } } }, "schema": { "$ref": "#/components/schemas/mes_ProblemDetailErrorResponse" } } }, "description": "Bad Request - Validation errors or no changes detected" }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/mes_ProblemDetailErrorResponse" } } }, "description": "Not Found - Mapping not found" }, "409": { "content": { "application/problem+json": { "examples": { "Output field already in use": { "description": "Output field already in use", "value": { "detail": "Output field is already in use by another mapping for this account", "identifier": "019a6ffb-f7f1-7025-8ad7-f65076ccdbf1", "instance": "https://api.example.com/v3/enrichment/transaction/lookup-list-mappings", "status": 409, "timestamp": "2025-11-10T22:56:15.345Z", "title": "OUTPUT_FIELD_LOOKUP_ALREADY_IN_USE", "type": "about:blank" } } }, "schema": { "$ref": "#/components/schemas/mes_ProblemDetailErrorResponse" } } }, "description": "Conflict - Output field already in use" } }, "summary": "Update a Lookup List Mapping", "tags": [ "Enrichment" ] } } }, "security": [ { "BearerAuth": [] } ], "servers": [ { "description": "ComplyAdvantage Mesh API", "url": "https://api.mesh.complyadvantage.com" } ], "tags": [ { "name": "Enrichment" } ] } ```