Render a search template

POST also GET /_render/template/{id}
POST also GET /_render/template

Render a search template as a search request body.

Required authorization

Index privileges: read

Path Parameters

id string Id optional

The ID of the search template to render. If no source is specified, this or the id request body parameter is required.

Leave it out to use /_render/template.

Request

Response

application/json

Examples

Run POST _render/template

Request Console 1 / 8 languages

Console Kibana Dev Tools

POST _render/template
{
  "id": "my-search-template",
  "params": {
    "query_string": "hello world",
    "from": 20,
    "size": 10
  }
}

JavaScript Elasticsearch JavaScript Client

const response = await client.renderSearchTemplate({
  id: "my-search-template",
  params: {
    query_string: "hello world",
    from: 20,
    size: 10,
  },
});

Python Elasticsearch Python Client

resp = client.render_search_template(
    id="my-search-template",
    params={
        "query_string": "hello world",
        "from": 20,
        "size": 10
    },
)

curl Shell

curl -X POST "$ELASTICSEARCH_URL/_render/template" \
  -H "Authorization: ApiKey $ELASTIC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "id": "my-search-template",
    "params": {
      "query_string": "hello world",
      "from": 20,
      "size": 10
    }
  }'

Java Elasticsearch Java Client

client.renderSearchTemplate(r -> r
    .id("my-search-template")
    .params(Map.of("size", JsonData.fromJson("10"),"from", JsonData.fromJson("20"),"query_string", JsonData.fromJson("\"hello world\"")))
);

C# Elasticsearch .NET Client

var response = await client
    .RenderSearchTemplateAsync(d1 => d1
        .Id("my-search-template")
        .Params(new Dictionary<string, object>()
        {
            { "query_string", "hello world" },
            { "from", 20 },
            { "size", 10 }
        })
    );

PHP Elasticsearch PHP Client

$resp = $client->renderSearchTemplate([
    "body" => [
        "id" => "my-search-template",
        "params" => [
            "query_string" => "hello world",
            "from" => 20,
            "size" => 10,
        ],
    ],
]);

Ruby Elasticsearch Ruby Client

response = client.render_search_template(
  body: {
    "id": "my-search-template",
    "params": {
      "query_string": "hello world",
      "from": 20,
      "size": 10
    }
  }
)

Response

No example

Required authorization

Path Parameters

Request { id , file , params , source , }

Response

Request