Search scan configurations
POST {{baseUrl}}/was/v2/configs/search?limit=-54086346&offset=-54086346&sort=last_seen:desc,ipv4:asc
Returns a list of web application scan configurations. If a scan has been run using the configuration, the list also contains information about the last scan that was run.
Requires BASIC [16] user permissions and CAN VIEW [16] scan permissions. See Permissions.
Request Params
Key | Datatype | Required | Description |
---|---|---|---|
limit | number | The number of records to retrieve. If this parameter is omitted, Tenable.io uses the default value of 10 . | |
offset | number | The starting record to retrieve. If this parameter is omitted, Tenable.io uses the default value of 0 . | |
sort | string | The 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
Key | Datatype | Required | Description |
---|---|---|---|
Content-Type | string |
RESPONSES
status: OK
{"page_number":0,"page_size":10,"order_by":"name","ordering":"asc","sort":[{"name":"configs.name","order":"asc"},{"name":"configs.created_at","order":"desc"},{"name":"configs.updated_at","order":"desc"}],"total_size":1690,"data":[{"config_id":"02fa2c34-142a-4c1d-9dbe-df231cb8db84","owner_id":"4dc95b60-8821-4280-be08-265ae01882a7","is_shared":false,"user_permissions":"configure","name":"3370","target":"http://example.com/","description":null,"created_at":"2020-05-12T09:43:42.620Z","updated_at":"2020-05-12T09:43:42.620Z","schedule":{"timezone":"Asia/Calcutta","starttime":"20200512T153000","rrule":"FREQ=YEARLY;COUNT=1","enabled":false},"template_id":"112f3e7f-d83a-4bba-b2c8-df2d22e2fa4c","last_scan":null,"user_template":null},{"config_id":"2062df2a-0e3d-411d-8dd7-0b95fae25863","owner_id":"1d480204-e7e3-494a-ae1d-ac72bda31ea7","is_shared":false,"user_permissions":"configure","name":"3370_WASTest","target":"http://example.com/","description":"test","created_at":"2020-05-12T10:06:06.919Z","updated_at":"2020-05-12T10:06:50.955Z","schedule":{"timezone":"Asia/Calcutta","starttime":"20200512T160000","rrule":"FREQ=YEARLY;COUNT=1","enabled":false},"template_id":"112f3e7f-d83a-4bba-b2c8-df2d22e2fa4c","last_scan":null,"user_template":null},{"config_id":"4d67bff6-c74b-3561-a378-36fc85968256","owner_id":"5ff4ad03-f168-4632-90fb-babf376579e9","is_shared":false,"user_permissions":"configure","name":"A1_WAS_scan","target":"http://example.com/","description":"","created_at":"2020-06-11T15:08:48Z","updated_at":"2020-06-11T15:08:48Z","schedule":null,"template_id":"b223f18e-5a94-4e02-b560-77a4a8246cd3","last_scan":null,"user_template":{"user_template_id":"78925a87-6a06-3f73-b0f9-d210b42e3b14","name":"A1_WAS_scan"}}],"pagination":{"total":1690,"offset":0,"limit":10,"sort":[{"name":"name","order":"asc"},{"name":"created_at","order":"desc"},{"name":"updated_at","order":"desc"}]},"items":[{"config_id":"02fa2c34-142a-4c1d-9dbe-df231cb8db84","owner_id":"4dc95b60-8821-4280-be08-265ae01882a7","is_shared":false,"user_permissions":"configure","name":"3370","target":"http://example.com/","description":null,"created_at":"2020-05-12T09:43:42.620Z","updated_at":"2020-05-12T09:43:42.620Z","schedule":{"timezone":"Asia/Calcutta","starttime":"20200512T153000","rrule":"FREQ=YEARLY;COUNT=1","enabled":false},"template_id":"112f3e7f-d83a-4bba-b2c8-df2d22e2fa4c","last_scan":null,"user_template":null},{"config_id":"2062df2a-0e3d-411d-8dd7-0b95fae25863","owner_id":"1d480204-e7e3-494a-ae1d-ac72bda31ea7","is_shared":false,"user_permissions":"configure","name":"3370_WASTest","target":"http://example.com/","description":"test","created_at":"2020-05-12T10:06:06.919Z","updated_at":"2020-05-12T10:06:50.955Z","schedule":{"timezone":"Asia/Calcutta","starttime":"20200512T160000","rrule":"FREQ=YEARLY;COUNT=1","enabled":false},"template_id":"112f3e7f-d83a-4bba-b2c8-df2d22e2fa4c","last_scan":null,"user_template":null},{"config_id":"4d67bff6-c74b-3561-a378-36fc85968256","owner_id":"5ff4ad03-f168-4632-90fb-babf376579e9","is_shared":false,"user_permissions":"configure","name":"A1_WAS_scan","target":"http://example.com/","description":"","created_at":"2020-06-11T15:08:48Z","updated_at":"2020-06-11T15:08:48Z","schedule":null,"template_id":"b223f18e-5a94-4e02-b560-77a4a8246cd3","last_scan":null,"user_template":{"user_template_id":"78925a87-6a06-3f73-b0f9-d210b42e3b14","name":"A1_WAS_scan"}}]}