Create an enrich policy

PUT /_enrich/policy/{name}

Creates an enrich policy.

Authentication

Authorization: <value>

Elasticsearch APIs use key-based authentication. You must create an API key and use the encoded value in the request header. For example:

		curl -X GET "${ES_URL}/_cat/indices?v=true" \
  -H "Authorization: ApiKey ${API_KEY}"

For more information about where to find API keys for the Elasticsearch endpoint (${ES_URL}) for a project, go to Get started with Elasticsearch Serverless.

Path parameters

Query parameters

Request body

Response

application/json

Examples

Request Console 1 / 8 languages

An example body for a PUT /_enrich/policy/postal_policy request.

Console Kibana Dev Tools

PUT /_enrich/policy/postal_policy
{
  "geo_match": {
    "indices": "postal_codes",
    "match_field": "location",
    "enrich_fields": [ "location", "postal_code" ]
  }
}

JavaScript Elasticsearch JavaScript Client

const response = await client.enrich.putPolicy({
  name: "postal_policy",
  geo_match: {
    indices: "postal_codes",
    match_field: "location",
    enrich_fields: ["location", "postal_code"],
  },
});

Python Elasticsearch Python Client

resp = client.enrich.put_policy(
    name="postal_policy",
    geo_match={
        "indices": "postal_codes",
        "match_field": "location",
        "enrich_fields": [
            "location",
            "postal_code"
        ]
    },
)

curl Shell

curl -X PUT "$ELASTICSEARCH_URL/_enrich/policy/postal_policy" \
  -H "Authorization: ApiKey $ELASTIC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "geo_match": {
      "indices": "postal_codes",
      "match_field": "location",
      "enrich_fields": [
        "location",
        "postal_code"
      ]
    }
  }'

Java Elasticsearch Java Client

client.enrich().putPolicy(p -> p
    .geoMatch(g -> g
        .enrichFields(List.of("location","postal_code"))
        .indices("postal_codes")
        .matchField("location")
    )
    .name("postal_policy")
);

C# Elasticsearch .NET Client

var response = await client.Enrich
    .PutPolicyAsync(name: "postal_policy", d1 => d1
        .GeoMatch(d2 => d2
            .EnrichFields(x => x.Location, x => x.PostalCode)
            .Indices(new[] { "postal_codes" })
            .MatchField(x => x.Location)
        )
    );

PHP Elasticsearch PHP Client

$resp = $client->enrich()->putPolicy([
    "name" => "postal_policy",
    "body" => [
        "geo_match" => [
            "indices" => "postal_codes",
            "match_field" => "location",
            "enrich_fields" => array(
                "location",
                "postal_code",
            ),
        ],
    ],
]);

Ruby Elasticsearch Ruby Client

response = client.enrich.put_policy(
  name: "postal_policy",
  body: {
    "geo_match": {
      "indices": "postal_codes",
      "match_field": "location",
      "enrich_fields": [
        "location",
        "postal_code"
      ]
    }
  }
)

Response

No example

Authentication

Path parameters

Query parameters

Request body { }

Response

Request body