Although I2E Queries and Multi Queries are binary objects, the I2E Web Services API provides an interface to a subset of the properties of those items, including some that can be modified when running a query programmatically.
Query properties that are read-only and that can be retrieved using the API include title, creator, comments and column headers. Query properties that can be modified before query submissions include number of hits, time limit and smart query parameters.
I2E has two, related, query resources: Saved Queries (that represent the binary files on disk, stored in the Repository) and Published Queries (that represent the Published location of the Saved Queries). To ensure that Users have permissions to see Query Properties, it is recommended that you only expose access to Published Queries.
Retrieving (by GET) a Published Query provides a “handle” to the Saved Query:
HTTP Header = X-Version: *, Accept: application/json GET http://i2e.company.com:8334/api;type=published_query/QueryTree/Query1.i2q Success 200
The response should look something like:
If you then retrieve that handle, you will receive an error because the server is trying to represent the query itself as JSON
HTTP Header = X-Version: *, Accept: application/json GET http://i2e.company.com:8334/api;type=saved_query/4.1/Query1.i2q Error 406