{"record":{"id":"26e75d5fc28751f5","repo":"BerriAI/litellm","slug":"a-mapping-with-those-claim-values-already-exists","errorCode":null,"errorMessage":"A mapping with those claim values already exists.","messagePattern":"A mapping with those claim values already exists\\.","errorType":"http","errorClass":"HTTPException","httpStatus":409,"severity":"error","filePath":"litellm/proxy/management_endpoints/jwt_key_mapping_endpoints.py","lineNumber":135,"sourceCode":"\n        cache_key = f\"jwt_key_mapping:{old_mapping.jwt_claim_name}:{old_mapping.jwt_claim_value}\"\n        await user_api_key_cache.async_delete_cache(cache_key)\n\n        updated_mapping: Final = await JWTKeyMappingRepository(prisma_client).table.update(\n            where={\"id\": data.id}, data=update_data\n        )\n\n        # Invalidate new cache key if claim fields changed\n        cache_key = f\"jwt_key_mapping:{updated_mapping.jwt_claim_name}:{updated_mapping.jwt_claim_value}\"\n        await user_api_key_cache.async_delete_cache(cache_key)\n\n        return _to_response(updated_mapping)\n    except HTTPException:\n        raise\n    except Exception as e:\n        error_str: Final = str(e).lower()\n        if \"unique\" in error_str or \"p2002\" in error_str:\n            raise HTTPException(\n                status_code=409,\n                detail=\"A mapping with those claim values already exists.\",\n            )\n        if \"foreign\" in error_str or \"p2003\" in error_str:\n            raise HTTPException(\n                status_code=400,\n                detail=\"The provided key does not match an existing virtual key.\",\n            )\n        raise HTTPException(status_code=500, detail=\"Failed to update JWT key mapping.\")\n\n\n@router.post(\"/jwt/key/mapping/delete\", tags=[\"JWT Key Mapping\"])\nasync def delete_jwt_key_mapping(\n    data: DeleteJWTKeyMappingRequest,\n    user_api_key_dict: UserAPIKeyAuth = Depends(user_api_key_auth),\n):\n    from litellm.proxy.proxy_server import prisma_client, user_api_key_cache\n","sourceCodeStart":117,"sourceCodeEnd":153,"githubUrl":"https://github.com/BerriAI/litellm/blob/77b7c6c40c0c5aa5fbcb1d6a1825ac39ca8829b8/litellm/proxy/management_endpoints/jwt_key_mapping_endpoints.py#L117-L153","documentation":"Error \"A mapping with those claim values already exists.\" thrown in BerriAI/litellm.","triggerScenarios":"Thrown at litellm/proxy/management_endpoints/jwt_key_mapping_endpoints.py:135 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["List existing mappings and update the existing one instead of creating a duplicate.","Choose different claim values that do not collide with an existing mapping."],"exampleFix":null,"handlingStrategy":null,"validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"77b7c6c40c0c5aa5fbcb1d6a1825ac39ca8829b8","analyzedAt":"2026-08-18T11:44:31.656Z","contentChangedAt":null,"schemaVersion":2},"datasetVersion":"2026-09-14T05:17:10.506Z"}