Link Search Menu Expand Document Documentation Menu

Get stored script

Introduced 1.0

Retrieves a stored script.

Endpoints

Image for: Endpoints
GET _scripts/my-first-script

Path parameters

Image for: Path parameters
Parameter Data type Description
script String Stored script or search template name. Required.

Query parameters

Image for: 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

Image for: Example request

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

GET _scripts/my-first-script

Example response

Image for: 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

Image for: 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 .