Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
ON THIS PAGE
 

POST /dynamic_search/saved_queries

SUMMARY Creates a query to be saved for use in dynamic searches. A query represents a request for data. Queries are not the same as searches, which are the results of a request for data. The benefit of saving a query is that it may be referenced in dynamic searches and can be reused.

Creates a query to be saved for use in dynamic searches. A query represents a request for data. Queries are not the same as searches, which are the results of a request for data. The benefit of saving a query is that it may be referenced in dynamic searches and can be reused.

Table 1: POST /dynamic_search/saved_queries resource details:

POST /dynamic_search/saved_queries resource details

MIME Type

application/json

Table 2: POST /dynamic_search/saved_queries request body details:

POST /dynamic_search/saved_queries request body details

Parameter Data Type MIME Type Description Sample

query

Object

application/json

The query to save.

{ "name": "sampleQuery", "query": "Please see the query example above" }
Table 3: POST /dynamic_search/saved_queries response codes:

POST /dynamic_search/saved_queries response codes

HTTP Response Code Unique Code Description

201

The query object created by the request.

409

5000

Caller has reached the maximum number of queries.

422

5002

The query must have a valid name.

422

1001

Error processing a supplied Field object (or one of its sub-objects).

422

1002

Error processing a supplied Filter object (or one of its sub-objects)

422

1003

Error processing a supplied Function object (or one of its sub-objects).

422

1004

Error processing a supplied Operator object (or one of its sub-objects).

422

1005

Error processing a supplied Range object (or one of its sub-objects).

422

1006

Error processing a supplied Sort object (or one of its sub-objects).

422

1007

Error combining elements of the Query object.

422

1012

A range was specified, but no sort provided

Response Description

The JSON representation of the query created by the request
  • id - String - A UUID to serve as a unique identifier for the query. This field is read-only.
  • query - String - The JSON representation of the query. This field is required.
  • name - String - A descriptive name for the query to make it easier to recall. This field is required.
  • creation_time - Long - The time in milliseconds since epoch that this query was created. This field is read-only.

Response Sample