Link Search Menu Expand Document Documentation Menu

Get stored script

Introduced 1.0

Retrieves a stored script.

Path and HTTP methods

GET _scripts/my-first-script

Path parameters

Parameter Data type Description
script String Stored script or search template name. Required.

Query parameters

Parameter Data type Description
cluster_manager_timeout Time Amount of time to wait for a connection to the cluster manager. Optional, defaults to 30s.

Example request

The following retrieves the my-first-script stored script.

GET _scripts/my-first-script

Example response

The GET _scripts/my-first-script request returns the following fields:

{
  "_id" : "my-first-script",
  "found" : true,
  "script" : {
    "lang" : "painless",
    "source" : """
          int total = 0;
          for (int i = 0; i < doc['ratings'].length; ++i) {
            total += doc['ratings'][i];
          }
          return total;
        """
  }
}

Response body fields

The GET _scripts/my-first-script request returns the following response fields:

Field Data type Description
_id String The script’s name.
found Boolean The requested script exists and was retrieved.
script Object The script definition. See Script object.

Script object

Field Data type Description
lang String The script’s language.
source String The script’s body.
350 characters left

Have a question? .

Want to contribute? or .