Search user-defined templates

POST {{baseUrl}}/was/v2/user-templates/search?limit=-54086346&offset=-54086346&sort=last_seen:desc,ipv4:asc

Returns a paginated list of user-defined templates that are available to be used for scan configurations.

Requires SCAN OPERATOR [24] user permissions and CAN USE [16] policy permissions. See Permissions.

Request Params

KeyDatatypeRequiredDescription
limitnumberThe number of records to retrieve. If this parameter is omitted, Tenable.io uses the default value of 10.
offsetnumberThe starting record to retrieve. If this parameter is omitted, Tenable.io uses the default value of 0.
sortstringThe field you want to use to sort the results by along with the sort order. The field is specified first, followed by a colon, and the order is specified second (asc or desc). For example, name:desc would sort results by the name field in descending order.

If you specify multiple fields, the fields must be separated by commas. For example, name:desc,created_at:asc would first sort results by the name field in descending order and then by the created_at field in ascending order. |

Request Body

{"AND"=>[{"field"=>"folder_name", "operator"=>"match", "value"=>"My Scans"}, {"field"=>"folder_name", "operator"=>"match", "value"=>"My Scans"}], "OR"=>[{"field"=>"folder_name", "operator"=>"match", "value"=>"My Scans"}, {"field"=>"folder_name", "operator"=>"match", "value"=>"My Scans"}]}

HEADERS

KeyDatatypeRequiredDescription
Content-Typestring

RESPONSES

status: OK

{"page_number":0,"page_size":4,"order_by":"name","ordering":"asc","sort":[{"name":"name","order":"asc"},{"name":"created_at","order":"desc"},{"name":"updated_at","order":"desc"}],"total_size":90,"data":[{"user_template_id":"78925a87-6a06-3f73-b0f9-d210b42e3b14","template_id":"b223f18e-5a94-4e02-b560-77a4a8246cd3","created_at":"2020-06-11T15:07:41Z","updated_at":"2020-08-04T13:54:41.726Z","name":"A1_WAS_scan","description":null,"owner_id":"4dc95b60-8821-4280-be08-265ae01882a7","container_id":"f02b6697-96b8-4b14-8d91-77105e2f7f6a","default_permissions":"no_access","results_visibility":"dashboard","permissions":[],"user_permissions":"configure","is_shared":false},{"user_template_id":"d0a1521e-8f8d-4fc6-8553-88be1a838089","template_id":"b223f18e-5a94-4e02-b560-77a4a8246cd3","created_at":"2020-08-06T12:58:14.027Z","updated_at":"2020-08-06T12:58:14.027Z","name":"another template","description":"things","owner_id":"5ff4ad03-f168-4632-90fb-babf376579e9","container_id":"f02b6697-96b8-4b14-8d91-77105e2f7f6a","default_permissions":"no_access","results_visibility":"dashboard","permissions":[],"user_permissions":"configure","is_shared":false},{"user_template_id":"ab8fd738-b9f1-4e26-a5ff-63835742cd87","template_id":"b223f18e-5a94-4e02-b560-77a4a8246cd3","created_at":"2020-08-06T13:43:09.815Z","updated_at":"2020-08-06T13:43:09.815Z","name":"a whole new template","description":null,"owner_id":"5ff4ad03-f168-4632-90fb-babf376579e9","container_id":"f02b6697-96b8-4b14-8d91-77105e2f7f6a","default_permissions":"no_access","results_visibility":"dashboard","permissions":[],"user_permissions":"configure","is_shared":false},{"user_template_id":"df3da42d-9423-493a-acb8-7dd14c7cbfdc","template_id":"b223f18e-5a94-4e02-b560-77a4a8246cd3","created_at":"2020-06-23T11:29:43.718Z","updated_at":"2020-07-27T20:18:28.369Z","name":"blabla - mode","description":null,"owner_id":"5ff4ad03-f168-4632-90fb-babf376579e9","container_id":"f02b6697-96b8-4b14-8d91-77105e2f7f6a","default_permissions":"no_access","results_visibility":"dashboard","permissions":[{"permissions_id":"49026468-2cf0-43e2-a14d-7c24b3c032b2","entity":"user","entity_id":"65dadc54-5871-449b-98ce-e8cd444967a9","level":"configure"}],"user_permissions":"configure","is_shared":true}],"pagination":{"total":90,"offset":0,"limit":4,"sort":[{"name":"name","order":"asc"},{"name":"created_at","order":"desc"},{"name":"updated_at","order":"desc"}]},"items":[{"user_template_id":"78925a87-6a06-3f73-b0f9-d210b42e3b14","template_id":"b223f18e-5a94-4e02-b560-77a4a8246cd3","created_at":"2020-06-11T15:07:41Z","updated_at":"2020-08-04T13:54:41.726Z","name":"A1_WAS_scan","description":null,"owner_id":"4dc95b60-8821-4280-be08-265ae01882a7","container_id":"f02b6697-96b8-4b14-8d91-77105e2f7f6a","default_permissions":"no_access","results_visibility":"dashboard","permissions":[],"user_permissions":"configure","is_shared":false},{"user_template_id":"d0a1521e-8f8d-4fc6-8553-88be1a838089","template_id":"b223f18e-5a94-4e02-b560-77a4a8246cd3","created_at":"2020-08-06T12:58:14.027Z","updated_at":"2020-08-06T12:58:14.027Z","name":"another template","description":"things","owner_id":"5ff4ad03-f168-4632-90fb-babf376579e9","container_id":"f02b6697-96b8-4b14-8d91-77105e2f7f6a","default_permissions":"no_access","results_visibility":"dashboard","permissions":[],"user_permissions":"configure","is_shared":false},{"user_template_id":"ab8fd738-b9f1-4e26-a5ff-63835742cd87","template_id":"b223f18e-5a94-4e02-b560-77a4a8246cd3","created_at":"2020-08-06T13:43:09.815Z","updated_at":"2020-08-06T13:43:09.815Z","name":"a whole new template","description":null,"owner_id":"5ff4ad03-f168-4632-90fb-babf376579e9","container_id":"f02b6697-96b8-4b14-8d91-77105e2f7f6a","default_permissions":"no_access","results_visibility":"dashboard","permissions":[],"user_permissions":"configure","is_shared":false},{"user_template_id":"df3da42d-9423-493a-acb8-7dd14c7cbfdc","template_id":"b223f18e-5a94-4e02-b560-77a4a8246cd3","created_at":"2020-06-23T11:29:43.718Z","updated_at":"2020-07-27T20:18:28.369Z","name":"blabla - mode","description":null,"owner_id":"5ff4ad03-f168-4632-90fb-babf376579e9","container_id":"f02b6697-96b8-4b14-8d91-77105e2f7f6a","default_permissions":"no_access","results_visibility":"dashboard","permissions":[{"permissions_id":"49026468-2cf0-43e2-a14d-7c24b3c032b2","entity":"user","entity_id":"65dadc54-5871-449b-98ce-e8cd444967a9","level":"configure"}],"user_permissions":"configure","is_shared":true}]}