from metadata.sdk import configure
from metadata.sdk.entities import Metrics

configure(
    host="https://your-company.open-metadata.org/api",
    jwt_token="your-jwt-token"
)

# The SDK calculates and submits JSON Patch from the changed entity.
metric = Metrics.retrieve("b8a9d6e4-2f7c-4f3a-9c1e-6d5b8a7f2e10")
metric.description = "Percentage of active customers retained month over month."
metric.displayName = "Monthly Customer Retention Rate"

updated = Metrics.update(metric)
print(f"Updated to version {updated.version}")

// client is an initialized OpenMetadataClient.
var metricId = "b8a9d6e4-2f7c-4f3a-9c1e-6d5b8a7f2e10";
var metric = client.metrics().get(metricId);

metric.setDescription(
    "Percentage of active customers retained month over month.");
metric.setDisplayName("Monthly Customer Retention Rate");

// update() calculates and submits JSON Patch from the fetched snapshot.
var updated = client.metrics().update(metricId, metric);
System.out.println("Updated to version " + updated.getVersion());

# Update by ID.
curl -X PATCH "{base_url}/api/v1/metrics/b8a9d6e4-2f7c-4f3a-9c1e-6d5b8a7f2e10" \
  -H "Authorization: Bearer {access_token}" \
  -H "Content-Type: application/json-patch+json" \
  -d '[
    {
      "op": "replace",
      "path": "/description",
      "value": "Percentage of active customers retained month over month."
    },
    {
      "op": "replace",
      "path": "/displayName",
      "value": "Monthly Customer Retention Rate"
    }
  ]'

# Update by fully qualified name.
curl -X PATCH "{base_url}/api/v1/metrics/name/customer_retention_rate" \
  -H "Authorization: Bearer {access_token}" \
  -H "Content-Type: application/json-patch+json" \
  -d '[
    {
      "op": "replace",
      "path": "/metricExpression/code",
      "value": "active_retained_customers * 100.0 / NULLIF(active_customers, 0)"
    }
  ]'

{
  "id": "b8a9d6e4-2f7c-4f3a-9c1e-6d5b8a7f2e10",
  "name": "customer_retention_rate",
  "displayName": "Monthly Customer Retention Rate",
  "fullyQualifiedName": "customer_retention_rate",
  "description": "Percentage of active customers retained month over month.",
  "metricExpression": {
    "language": "SQL",
    "code": "retained_customers * 100.0 / NULLIF(total_customers, 0)"
  },
  "metricType": "RATIO",
  "unitOfMeasurement": "PERCENTAGE",
  "granularity": "MONTH",
  "version": 0.2,
  "updatedAt": 1787760600000,
  "updatedBy": "admin",
  "href": "https://your-company.open-metadata.org/api/v1/metrics/b8a9d6e4-2f7c-4f3a-9c1e-6d5b8a7f2e10",
  "deleted": false
}