openapi: 3.1.0 info: title: PDCP API version: '1.0' summary: ProjectDiscovery Cloud Platform description: 'For more details, checkout https://docs.projectdiscovery.io/api-reference/editor/scan' servers: - url: 'https://api.projectdiscovery.io' description: Production - url: 'https://api.dev.projectdiscovery.io' description: Development - url: 'http://localhost:8080' description: Localhost paths: /v1/scans: get: operationId: get-v1-scans summary: Get Scan List description: Get user scans status parameters: - name: offset in: query description: number of scan-status results to skip schema: type: integer - name: limit in: query description: number of scan-status results to fetch schema: type: integer - name: search in: query description: search term for running scans schema: type: string - name: status in: query description: 'filter by status (failed, finished, queued, running, starting, uploaded, scheduled)' schema: type: string - name: sort_asc in: query description: 'comma separated ascending sorting e.g sort_asc=created_at,severity' schema: type: string - name: sort_desc in: query description: 'comma separated descending sorting e.g sort_desc=created_at,severity' schema: type: string - name: X-Team-Id in: header description: 'Retrieve the Team ID from: https://cloud.projectdiscovery.io/settings/team' schema: type: string responses: '200': $ref: '#/components/responses/GetScansStatusResponse' '400': $ref: '#/components/responses/ErrorResponse' '401': $ref: '#/components/responses/ErrorResponse' '499': $ref: '#/components/responses/ErrorResponse' '500': $ref: '#/components/responses/ErrorResponse' default: $ref: '#/components/responses/ErrorResponse' security: - X-API-Key: [] tags: - scans x-internal: false post: operationId: post-v1-scans summary: Create Scan description: Trigger a scan parameters: - name: X-Team-Id in: header description: 'Retrieve the Team ID from: https://cloud.projectdiscovery.io/settings/team' schema: type: string requestBody: $ref: '#/components/requestBodies/TriggerUserScanRequest' responses: '200': $ref: '#/components/responses/TriggerUserScanResponse' '400': $ref: '#/components/responses/ErrorResponse' '401': $ref: '#/components/responses/ErrorResponse' '500': $ref: '#/components/responses/ErrorResponse' default: $ref: '#/components/responses/ErrorResponse' security: - X-API-Key: [] tags: - scans delete: operationId: delete-v1-scans summary: Delete Bulk Scans description: Delete multiple scans using scan ids parameters: - name: X-Team-Id in: header description: 'Retrieve the Team ID from: https://cloud.projectdiscovery.io/settings/team' schema: type: string requestBody: content: application/json: schema: type: object properties: scan_ids: type: array items: type: string required: - scan_ids responses: '200': $ref: '#/components/responses/DeleteScansResponse' '400': $ref: '#/components/responses/ErrorResponse' '401': $ref: '#/components/responses/ErrorResponse' '500': $ref: '#/components/responses/ErrorResponse' default: $ref: '#/components/responses/ErrorResponse' security: - X-API-Key: [] tags: - scans '/v1/scans/{scan_id}': parameters: - name: scan_id in: path required: true schema: type: string get: operationId: get-v1-scans-scan_id summary: Get Scan description: Get details of a scan by scan ID parameters: - name: X-Team-Id in: header description: 'Retrieve the Team ID from: https://cloud.projectdiscovery.io/settings/team' schema: type: string responses: '200': $ref: '#/components/responses/GetScanDetailsResponse' '400': $ref: '#/components/responses/ErrorResponse' '401': $ref: '#/components/responses/ErrorResponse' '404': $ref: '#/components/responses/ErrorResponse' '499': $ref: '#/components/responses/ErrorResponse' '500': $ref: '#/components/responses/ErrorResponse' default: $ref: '#/components/responses/ErrorResponse' security: - X-API-Key: [] tags: - scans delete: operationId: delete-v1-scans-scan_id summary: Delete Scan description: Delete a scan using scanId parameters: - name: X-Team-Id in: header description: 'Retrieve the Team ID from: https://cloud.projectdiscovery.io/settings/team' schema: type: string responses: '200': $ref: '#/components/responses/DeleteScansResponse' '400': $ref: '#/components/responses/ErrorResponse' '401': $ref: '#/components/responses/ErrorResponse' '500': $ref: '#/components/responses/ErrorResponse' default: $ref: '#/components/responses/ErrorResponse' security: - X-API-Key: [] tags: - scans patch: operationId: patch-v1-scans-scan_id summary: Update Scan description: Update scan metadata parameters: - name: X-Team-Id in: header description: 'Retrieve the Team ID from: https://cloud.projectdiscovery.io/settings/team' schema: type: string requestBody: $ref: '#/components/requestBodies/UpdateScanRequest' responses: '200': $ref: '#/components/responses/MessageResponse' '400': $ref: '#/components/responses/ErrorResponse' '401': $ref: '#/components/responses/ErrorResponse' '500': $ref: '#/components/responses/ErrorResponse' default: $ref: '#/components/responses/ErrorResponse' security: - X-API-Key: [] tags: - scans /v1/scans/import: post: operationId: post-v1-scans-import summary: Import OSS Scan description: Import scan details parameters: - name: name in: query schema: type: string - name: X-Team-Id in: header description: 'Retrieve the Team ID from: https://cloud.projectdiscovery.io/settings/team' schema: type: string requestBody: content: application/octet-stream: schema: type: string format: binary responses: '200': $ref: '#/components/responses/ImportScanResponse' '400': $ref: '#/components/responses/ErrorResponse' '401': $ref: '#/components/responses/ErrorResponse' '500': $ref: '#/components/responses/ErrorResponse' default: $ref: '#/components/responses/ErrorResponse' security: - X-API-Key: [] tags: - scans '/v1/scans/{scan_id}/stop': parameters: - name: scan_id in: path required: true schema: type: string post: operationId: post-v1-scans-scan_id-stop summary: Stop Scan description: 'Stop a running scan, not applied in any other state.' parameters: - name: X-Team-Id in: header description: 'Retrieve the Team ID from: https://cloud.projectdiscovery.io/settings/team' schema: type: string responses: '200': $ref: '#/components/responses/DeleteScansResponse' '400': $ref: '#/components/responses/ErrorResponse' '401': $ref: '#/components/responses/ErrorResponse' '500': $ref: '#/components/responses/ErrorResponse' default: $ref: '#/components/responses/ErrorResponse' security: - X-API-Key: [] tags: - scans '/v1/scans/{scan_id}/rescan': parameters: - name: scan_id in: path required: true schema: type: string post: operationId: post-v1-scans-scan_id-rescan summary: Rescan scan description: Re-run a existing scan parameters: - name: X-Team-Id in: header description: 'Retrieve the Team ID from: https://cloud.projectdiscovery.io/settings/team' schema: type: string responses: '200': $ref: '#/components/responses/TriggerUserScanResponse' '400': $ref: '#/components/responses/ErrorResponse' '401': $ref: '#/components/responses/ErrorResponse' '500': $ref: '#/components/responses/ErrorResponse' default: $ref: '#/components/responses/ErrorResponse' security: - X-API-Key: [] tags: - scans '/v1/scans/vuln/{vuln_id}': get: operationId: 'get-v1-scans-vuln-:vulnId' summary: Get Scan Vulnerability description: 'Get scan result vulnerability by ID ' parameters: - name: X-Team-Id in: header description: 'Retrieve the Team ID from: https://cloud.projectdiscovery.io/settings/team' schema: type: string responses: '200': $ref: '#/components/responses/GetScansVulnIdResponse' '400': $ref: '#/components/responses/ErrorResponse' '401': $ref: '#/components/responses/ErrorResponse' '500': $ref: '#/components/responses/ErrorResponse' default: $ref: '#/components/responses/ErrorResponse' security: - X-API-Key: [] tags: - results parameters: - name: vuln_id in: path description: vulnerability ID required: true schema: type: string '/v1/scans/result/{scanId}': get: operationId: 'get-v1-scans-result-:scanId' summary: Get Scan Results description: get results of specific scan by id parameters: - name: severity in: query description: 'comma separated severity e.g. severity=info,high' schema: type: string - name: search in: query description: search term schema: type: string - name: limit in: query description: 'number of results ' schema: type: integer - name: offset in: query description: number of results to skip schema: type: integer - name: templates in: query description: 'comma separated templates e.g. templates=tech-detect,azure-takeover' schema: type: string - name: hosts in: query description: 'comma separated host e.g. hosts=https://example.com,https://x.com' schema: type: string - name: time in: query description: 'filter by time ( last_day, last_week, last_month )' schema: type: string - name: vuln_status in: query description: 'comma separated vuln_status e.g vuln_status=open,fixed' schema: type: string - name: sort_asc in: query description: 'comma separated ascending sorting e.g sort_asc=created_at,severity' schema: type: string - name: sort_desc in: query description: 'comma separated descending sorting e.g sort_desc=created_at,severity' schema: type: string - name: X-Team-Id in: header description: 'Retrieve the Team ID from: https://cloud.projectdiscovery.io/settings/team' schema: type: string responses: '200': $ref: '#/components/responses/GetScanResultsResponse' '400': $ref: '#/components/responses/ErrorResponse' '401': $ref: '#/components/responses/ErrorResponse' '499': $ref: '#/components/responses/ErrorResponse' '500': $ref: '#/components/responses/ErrorResponse' default: $ref: '#/components/responses/ErrorResponse' security: - X-API-Key: [] tags: - results parameters: - name: scanId in: path description: scan specific results (by scanId) required: true schema: type: string /v1/scans/results: get: operationId: get-v1-results summary: Get All Results description: Get scans results of a user parameters: - name: offset in: query description: number of results to skip schema: type: integer - name: limit in: query description: number of results to get schema: type: integer - name: severity in: query description: 'string separated by comma e.g. info,high' schema: type: string - name: search in: query description: search term schema: type: string - name: hosts in: query description: 'comma separated host e.g. hosts=https://example.com,https://x.com' schema: type: string - name: templates in: query description: 'comma separated templates e.g. templates=tech-detect,azure-takeover' schema: type: string - name: time in: query description: 'filter by time ( last_day, last_week, last_month )' schema: type: string - name: vuln_status in: query description: 'comma separated vuln_status e.g vuln_status=open,fixed' schema: type: string - name: tags in: query description: 'comma separated tags e.g tags=xss,cve' schema: type: string - name: sort_asc in: query description: 'comma separated ascending sorting e.g sort_asc=created_at,severity' schema: type: string - name: sort_desc in: query description: 'comma separated descending sorting e.g sort_desc=created_at,severity' schema: type: string - name: is_ticket in: query description: Return the records that have issue trackers schema: type: boolean - name: labels in: query description: 'filter by comma separated labels e.g labels=p1,p2' schema: type: string - name: X-Team-Id in: header description: 'Retrieve the Team ID from: https://cloud.projectdiscovery.io/settings/team' schema: type: string responses: '200': $ref: '#/components/responses/GetScanResultsResponse' '400': $ref: '#/components/responses/ErrorResponse' '401': $ref: '#/components/responses/ErrorResponse' '499': $ref: '#/components/responses/ErrorResponse' '500': $ref: '#/components/responses/ErrorResponse' default: $ref: '#/components/responses/ErrorResponse' security: - X-API-Key: [] tags: - results parameters: [] /v1/scans/stats: get: operationId: get-v1-scans-stats summary: Get All Scan Stats description: Get all scans statistics for a user parameters: - name: X-Team-Id in: header description: 'Retrieve the Team ID from: https://cloud.projectdiscovery.io/settings/team' schema: type: string responses: '200': $ref: '#/components/responses/ScanStatsResponse' '401': $ref: '#/components/responses/ErrorResponse' '403': $ref: '#/components/responses/ErrorResponse' '499': $ref: '#/components/responses/ErrorResponse' '500': $ref: '#/components/responses/ErrorResponse' default: $ref: '#/components/responses/ErrorResponse' security: - X-API-Key: [] tags: - scans '/v1/scans/{vuln_id}/retest': parameters: - name: vuln_id in: path required: true schema: type: string post: operationId: post-v1-scans-vuln_id-retest summary: Retest vulnerability description: Retest a scan vulnerability parameters: - name: X-Team-Id in: header description: 'Retrieve the Team ID from: https://cloud.projectdiscovery.io/settings/team' schema: type: string responses: '200': $ref: '#/components/responses/PostRescanVulnResponse' '400': $ref: '#/components/responses/ErrorResponse' '401': $ref: '#/components/responses/ErrorResponse' '500': $ref: '#/components/responses/ErrorResponse' default: $ref: '#/components/responses/ErrorResponse' security: - X-API-Key: [] tags: - scans /v1/scans/results/filters: get: operationId: get-v1-scans-results-filters summary: Get Scans Result Filters description: Get users scan-result filters parameters: - name: offset in: query description: The number of items to skip before starting to collect the result set schema: type: integer - name: limit in: query description: The numbers of items to return schema: type: integer - name: scan_id in: query description: specific scan_id results filters schema: type: string - name: severity in: query description: 'comma separated severity e.g. severities=info,high' schema: type: string - name: templates in: query description: 'comma separated templates e.g. templates=tech-detect,azure-takeover' schema: type: string - name: hosts in: query description: 'comma separated host e.g. hosts=https://example.com,https://x.com' schema: type: string - name: search in: query description: search term schema: type: string - name: type in: query description: type of filter required: true schema: type: string - name: time in: query description: 'filter by time ( last_day, last_week, last_month )' schema: type: string - name: vuln_status in: query description: 'comma separated vuln_status e.g vuln_status=open,fixed' schema: type: string - name: sort_asc in: query description: 'comma separated ascending sorting e.g sort_asc=created_at,severity' schema: type: string - name: sort_desc in: query description: 'comma separated descending sorting e.g sort_desc=created_at,severity' schema: type: string - name: tags in: query description: 'comma separated tags e.g tags=xss,cve' schema: type: string - name: not_hosts in: query description: 'comma separated hosts that should not be returned e.g. not_hosts=https://example.com,https://x.com' schema: type: string - name: not_severity in: query description: 'comma separated severity that should not be returned e.g. not_severity=info,high' schema: type: string - name: not_templates in: query description: 'comma separated templates that should not be returned e.g. not_templates=tech-detect,azure-takeover' schema: type: string - name: labels in: query description: 'filter by comma separated labels e.g labels=p1,p2' schema: type: string - name: X-Team-Id in: header description: 'Retrieve the Team ID from: https://cloud.projectdiscovery.io/settings/team' schema: type: string responses: '200': $ref: '#/components/responses/GetScanResultsFiltersResponse' '401': $ref: '#/components/responses/ErrorResponse' '499': $ref: '#/components/responses/ErrorResponse' '500': $ref: '#/components/responses/ErrorResponse' default: $ref: '#/components/responses/ErrorResponse' security: - X-API-Key: [] tags: - results /v1/scans/results/stats: get: operationId: get-v1-scans-results-stats summary: Get Results Stats description: Get user scan results stats parameters: - name: offset in: query description: The number of items to skip before starting to collect the result set schema: type: integer - name: limit in: query description: The numbers of items to return schema: type: integer - name: hosts in: query description: 'comma separated host e.g. hosts=https://example.com,https://x.com' schema: type: string - name: templates in: query description: 'comma separated templates e.g. templates=tech-detect,azure-takeover' schema: type: string - name: severity in: query description: 'comma separated severity e.g. severities=info,high' schema: type: string - name: search in: query description: search term schema: type: string - name: scan_id in: query description: specific scan_id results filters schema: type: string - name: time in: query description: 'filter by time ( last_day, last_week, last_month )' schema: type: string - name: vuln_status in: query description: 'comma separated vuln_status e.g vuln_status=open,fixed' schema: type: string - name: tags in: query description: 'comma separated tags e.g tags=xss,cve' schema: type: string - name: not_hosts in: query description: 'comma separated hosts that should not be returned e.g. not_hosts=https://example.com,https://x.com' schema: type: string - name: not_severity in: query description: 'comma separated severity that should not be returned e.g. not_severity=info,high' schema: type: string - name: not_templates in: query description: 'comma separated templates that should not be returned e.g. not_templates=tech-detect,azure-takeover' schema: type: string - name: labels in: query description: 'filter by comma separated labels e.g labels=p1,p2' schema: type: string - name: X-Team-Id in: header description: 'Retrieve the Team ID from: https://cloud.projectdiscovery.io/settings/team' schema: type: string responses: '200': $ref: '#/components/responses/GetScanResultStatsResponse' '400': $ref: '#/components/responses/ErrorResponse' '401': $ref: '#/components/responses/ErrorResponse' '499': $ref: '#/components/responses/ErrorResponse' '500': $ref: '#/components/responses/ErrorResponse' default: $ref: '#/components/responses/ErrorResponse' security: - X-API-Key: [] tags: - results /v1/scans/schedule: get: operationId: get-v1-scans-schedule summary: Get Scan Schedules description: Get scan schedules for a user parameters: - name: X-Team-Id in: header description: 'Retrieve the Team ID from: https://cloud.projectdiscovery.io/settings/team' schema: type: string responses: '200': $ref: '#/components/responses/GetScanScheduleResponse' '400': $ref: '#/components/responses/GetScanScheduleResponse' '401': $ref: '#/components/responses/SetScanScheduleResponse' '500': $ref: '#/components/responses/SetScanScheduleResponse' security: - X-API-Key: [] tags: - scans post: operationId: post-v1-scans-schedule summary: Set Scan Schedule description: 'set a scan schedule for a user ' parameters: - name: X-Team-Id in: header description: 'Retrieve the Team ID from: https://cloud.projectdiscovery.io/settings/team' schema: type: string requestBody: $ref: '#/components/requestBodies/SetScanScheduleRequest' responses: '200': $ref: '#/components/responses/SetScanScheduleResponse' '400': $ref: '#/components/responses/SetScanScheduleResponse' '401': $ref: '#/components/responses/SetScanScheduleResponse' '500': $ref: '#/components/responses/SetScanScheduleResponse' default: $ref: '#/components/responses/ErrorResponse' security: - X-API-Key: [] tags: - scans delete: operationId: delete-v1-scans-schedule summary: Delete Scan Schedule description: Delete scan schedule for a user parameters: - name: scan_id in: query description: scan_id of schedule to be deleted required: true schema: type: string - name: X-Team-Id in: header description: 'Retrieve the Team ID from: https://cloud.projectdiscovery.io/settings/team' schema: type: string responses: '200': $ref: '#/components/responses/DeleteScanScheduleResponse' '400': $ref: '#/components/responses/DeleteScanScheduleResponse' '401': $ref: '#/components/responses/DeleteScanScheduleResponse' '500': $ref: '#/components/responses/DeleteScanScheduleResponse' default: $ref: '#/components/responses/ErrorResponse' security: - X-API-Key: [] tags: - scans /v1/retest: get: operationId: get-v1-retest summary: Get All Retest description: Get user retest results parameters: - name: offset in: query description: number of results to skip required: true schema: type: integer - name: limit in: query description: number of results required: true schema: type: integer - name: X-Team-Id in: header description: 'Retrieve the Team ID from: https://cloud.projectdiscovery.io/settings/team' schema: type: string responses: '200': $ref: '#/components/responses/GetRetestResultsResponse' '401': $ref: '#/components/responses/GetRetestResultsResponse' '500': $ref: '#/components/responses/GetRetestResultsResponse' security: - X-API-Key: [] tags: - retests post: operationId: post-v1-retest summary: Create Retest description: Trigger a retest scan parameters: - name: X-Team-Id in: header description: 'Retrieve the Team ID from: https://cloud.projectdiscovery.io/settings/team' schema: type: string requestBody: $ref: '#/components/requestBodies/RetestTemplateRequest' responses: '200': $ref: '#/components/responses/PostRetestTemplateResponse' '400': $ref: '#/components/responses/PostRetestTemplateResponse' '401': $ref: '#/components/responses/PostRetestTemplateResponse' '500': $ref: '#/components/responses/PostRetestTemplateResponse' security: - X-API-Key: [] tags: - retests parameters: [] '/v1/retest/{vuln_id}': get: operationId: get-v1-retest-vuln_id summary: Get Retest Vulnerability description: Get retest vulnerability (retests from editor) parameters: - name: X-Team-Id in: header description: 'Retrieve the Team ID from: https://cloud.projectdiscovery.io/settings/team' schema: type: string responses: '200': $ref: '#/components/responses/GetSingleRetestResultResponse' '400': $ref: '#/components/responses/GetSingleRetestResultResponse' '401': $ref: '#/components/responses/GetSingleRetestResultResponse' '500': $ref: '#/components/responses/GetSingleRetestResultResponse' security: - X-API-Key: [] tags: - retests parameters: - name: vuln_id in: path required: true schema: type: string /v1/assets: get: operationId: get-v1-assets summary: Get Asset List description: Get user asset list parameters: - name: offset in: query description: number of assets to skip schema: type: integer - name: limit in: query description: number of assets to fetch schema: type: integer - name: search in: query description: search term for asset list schema: type: string - name: X-Team-Id in: header description: 'Retrieve the Team ID from: https://cloud.projectdiscovery.io/settings/team' schema: type: string responses: '200': $ref: '#/components/responses/GetAssetsListResponse' '401': $ref: '#/components/responses/ErrorResponse' '500': $ref: '#/components/responses/ErrorResponse' default: $ref: '#/components/responses/ErrorResponse' security: - X-API-Key: [] tags: - assets post: operationId: post-v1-assets summary: Upload Asset description: Manually upload user assets (uploaded to manual enumeration) parameters: - name: name in: query description: name of asset schema: type: string - name: X-Team-Id in: header description: 'Retrieve the Team ID from: https://cloud.projectdiscovery.io/settings/team' schema: type: string - name: Content-Type in: header description: set the content type header schema: type: string requestBody: content: application/octet-stream: schema: type: string format: binary responses: '200': $ref: '#/components/responses/UploadAssetResponse' '401': $ref: '#/components/responses/ErrorResponse' '500': $ref: '#/components/responses/ErrorResponse' default: $ref: '#/components/responses/ErrorResponse' security: - X-API-Key: [] tags: - assets '/v1/assets/{asset_Id}': parameters: - name: asset_Id in: path required: true schema: type: string get: operationId: get-v1-assets-assetId summary: Get Asset Metadata description: Get asset metadata parameters: - name: X-Team-Id in: header description: 'Retrieve the Team ID from: https://cloud.projectdiscovery.io/settings/team' schema: type: string responses: '200': $ref: '#/components/responses/GetUserAssetResponse' '401': $ref: '#/components/responses/ErrorResponse' '500': $ref: '#/components/responses/ErrorResponse' default: $ref: '#/components/responses/ErrorResponse' security: - X-API-Key: [] tags: - assets delete: operationId: delete-v1-assets-asset_Id summary: Delete Asset description: Delete asset by ID parameters: - name: X-Team-Id in: header description: 'Retrieve the Team ID from: https://cloud.projectdiscovery.io/settings/team' schema: type: string responses: '200': $ref: '#/components/responses/DeleteAssetResponse' '401': $ref: '#/components/responses/ErrorResponse' '500': $ref: '#/components/responses/ErrorResponse' default: $ref: '#/components/responses/ErrorResponse' security: - X-API-Key: [] tags: - assets patch: operationId: patch-v1-assets-asset_Id summary: Update Asset Metadata description: Update asset metadata parameters: - name: X-Team-Id in: header description: 'Retrieve the Team ID from: https://cloud.projectdiscovery.io/settings/team' schema: type: string requestBody: $ref: '#/components/requestBodies/UpdateAssetRequest' responses: '200': description: OK content: application/json: schema: type: object properties: message: type: string required: - message '401': $ref: '#/components/responses/ErrorResponse' '500': $ref: '#/components/responses/ErrorResponse' default: $ref: '#/components/responses/ErrorResponse' security: - X-API-Key: [] tags: - assets '/v1/assets/{asset_id}/contents': get: operationId: get-v1-assets-id-contents summary: Get Asset Content description: Get user asset content parameters: - name: X-Team-Id in: header description: 'Retrieve the Team ID from: https://cloud.projectdiscovery.io/settings/team' schema: type: string responses: '200': description: OK content: application/octet-stream: schema: type: string format: binary '401': $ref: '#/components/responses/ErrorResponse' '500': $ref: '#/components/responses/ErrorResponse' default: $ref: '#/components/responses/ErrorResponse' security: - X-API-Key: [] tags: - assets parameters: - name: asset_id in: path required: true schema: type: string patch: operationId: patch-v1-assets-asset_id-contents summary: Update Asset Content description: Update existing asset content parameters: - name: update_type in: query description: 'use append or replace ' schema: type: string enum: - append - replace - name: X-Team-Id in: header description: 'Retrieve the Team ID from: https://cloud.projectdiscovery.io/settings/team' schema: type: string - name: Content-Type in: header description: set the content type header schema: type: string requestBody: content: application/octet-stream: schema: type: string format: binary responses: '200': $ref: '#/components/responses/PatchAssetContentResponse' '400': $ref: '#/components/responses/ErrorResponse' '500': $ref: '#/components/responses/ErrorResponse' default: $ref: '#/components/responses/ErrorResponse' security: - X-API-Key: [] tags: - assets /v1/user/feedback: post: operationId: post-v1-user-feedback summary: Create Feedback description: Add user feedback parameters: - name: X-Team-Id in: header description: 'Retrieve the Team ID from: https://cloud.projectdiscovery.io/settings/team' schema: type: string requestBody: $ref: '#/components/requestBodies/PostFeedbackRequest' responses: '200': description: OK content: application/json: schema: type: object properties: message: type: string required: - message '401': description: Shared Response content: application/json: schema: type: object properties: message: type: string required: - message '500': description: Internal Server Error content: application/json: schema: type: object properties: message: type: string required: - message security: - X-API-Key: [] tags: - users /v1/user/delete/code: parameters: [] post: operationId: post-v1-user-delete-code summary: Email user deletion verification code description: generate and email user deletion verification code parameters: - name: X-Team-Id in: header description: 'Retrieve the Team ID from: https://cloud.projectdiscovery.io/settings/team' schema: type: string responses: '200': $ref: '#/components/responses/MessageResponse' '400': $ref: '#/components/responses/MessageResponse' '403': $ref: '#/components/responses/MessageResponse' '500': $ref: '#/components/responses/MessageResponse' security: - X-API-Key: [] tags: - users /v1/user: get: operationId: get-v1-user summary: Get User Profile description: Get user profile and permissions parameters: - name: X-Team-Id in: header description: 'Retrieve the Team ID from: https://cloud.projectdiscovery.io/settings/team' schema: type: string responses: '200': $ref: '#/components/responses/GetUserProfileResponse' '401': $ref: '#/components/responses/GetUserProfileResponse' '500': $ref: '#/components/responses/GetUserProfileResponse' security: - X-API-Key: [] tags: - users delete: operationId: delete-v1-user summary: Delete user from system along with all data parameters: - name: X-Team-Id in: header description: 'Retrieve the Team ID from: https://cloud.projectdiscovery.io/settings/team' schema: type: string requestBody: content: application/json: schema: type: object properties: code: type: string required: - code responses: '200': $ref: '#/components/responses/MessageResponse' '400': $ref: '#/components/responses/MessageResponse' '403': $ref: '#/components/responses/MessageResponse' '500': $ref: '#/components/responses/MessageResponse' security: - X-API-Key: [] tags: - users /v1/user/apikey: get: operationId: get-v1-user-apikey summary: Get API Key description: Get user api-key responses: '200': $ref: '#/components/responses/GetUserAPIKeyResponse' '401': $ref: '#/components/responses/GetUserAPIKeyResponse' '404': $ref: '#/components/responses/GetUserAPIKeyResponse' '500': $ref: '#/components/responses/GetUserAPIKeyResponse' security: - X-API-Key: [] tags: - users post: operationId: post-v1-user-apikey summary: Create API Key description: 'Create user api-key, this won''t create a new api-key if it already exists.' responses: '200': $ref: '#/components/responses/GetUserAPIKeyResponse' '400': $ref: '#/components/responses/GetUserAPIKeyResponse' '500': $ref: '#/components/responses/GetUserAPIKeyResponse' security: - X-API-Key: [] tags: - users delete: operationId: delete-v1-user-apikey summary: Delete API Key description: Delete user api-key responses: '200': $ref: '#/components/responses/DeleteUserAPIKeyResponse' '401': $ref: '#/components/responses/DeleteUserAPIKeyResponse' '500': $ref: '#/components/responses/DeleteUserAPIKeyResponse' security: - X-API-Key: [] tags: - users /v1/user/apikey/rotate: post: operationId: post-v1-user-apikey-rotate summary: Rotate API Key description: Rotate user api-key responses: '200': $ref: '#/components/responses/PostApiKeyRotateResponse' '401': $ref: '#/components/responses/PostApiKeyRotateResponse' '500': $ref: '#/components/responses/PostApiKeyRotateResponse' security: - X-API-Key: [] tags: - users /v1/template/public: get: operationId: get-v1-template-public summary: Get Public Template List description: Get public-template list parameters: - name: X-Team-Id in: header description: 'Retrieve the Team ID from: https://cloud.projectdiscovery.io/settings/team' schema: type: string responses: '200': $ref: '#/components/responses/GetPublicTemplateList' '201': $ref: '#/components/responses/GetPublicTemplateList' '500': $ref: '#/components/responses/GetPublicTemplateList' tags: - templates /v1/template/early: get: operationId: get-v1-early-templates summary: Get Early Template List description: Get pdcp early template lists parameters: - name: X-Team-Id in: header description: 'Retrieve the Team ID from: https://cloud.projectdiscovery.io/settings/team' schema: type: string responses: '200': $ref: '#/components/responses/GetEarlyTempateList' '400': $ref: '#/components/responses/MessageResponse' '403': $ref: '#/components/responses/MessageResponse' '500': $ref: '#/components/responses/MessageResponse' security: - X-API-Key: [] tags: - templates parameters: [] '/v1/template/early/{id}': get: operationId: get-v1-early-templates-id summary: Get Early Template description: Get early template text parameters: - name: X-Team-Id in: header description: 'Retrieve the Team ID from: https://cloud.projectdiscovery.io/settings/team' schema: type: string responses: '200': description: Shared Response content: text/plain: schema: type: string '400': $ref: '#/components/responses/MessageResponse' '403': $ref: '#/components/responses/MessageResponse' '404': $ref: '#/components/responses/MessageResponse' '500': $ref: '#/components/responses/MessageResponse' security: - X-API-Key: [] tags: - templates parameters: - name: id in: path required: true schema: type: string '/v1/template/public/{template_id}': get: summary: Get Public Template tags: - templates responses: '200': $ref: '#/components/responses/GetTemplateDataResponse' '400': $ref: '#/components/responses/MessageResponse' '500': $ref: '#/components/responses/MessageResponse' default: $ref: '#/components/responses/MessageResponse' operationId: get-v1-public-template-data description: Get public template data using template id parameters: - schema: type: string in: query name: fields description: 'template data fields ' - schema: type: string in: header name: X-Team-Id description: 'Retrieve the Team ID from: https://cloud.projectdiscovery.io/settings/team' parameters: - schema: type: string name: template_id in: path required: true description: 'Public Template ID' /v1/template: get: operationId: get-v1-templates summary: Get Template List description: Get user private(my) templates parameters: - name: X-Team-Id in: header description: 'Retrieve the Team ID from: https://cloud.projectdiscovery.io/settings/team' schema: type: string responses: '200': $ref: '#/components/responses/GetUserTemplateListResponse' '401': $ref: '#/components/responses/GetUserTemplateListResponse' '500': $ref: '#/components/responses/GetUserTemplateListResponse' security: - X-API-Key: [] tags: - templates parameters: [] post: operationId: post-v1-template summary: Create Template description: Create a private template parameters: - name: X-Team-Id in: header description: 'Retrieve the Team ID from: https://cloud.projectdiscovery.io/settings/team' schema: type: string requestBody: content: application/json: schema: type: object properties: template: type: string prompt: type: string required: - template responses: '200': $ref: '#/components/responses/CreateTemplateResponse' '400': $ref: '#/components/responses/MessageResponse' '401': $ref: '#/components/responses/MessageResponse' '500': $ref: '#/components/responses/MessageResponse' security: - X-API-Key: [] tags: - templates patch: operationId: patch-v1-template summary: Update Template description: 'Update existing private template ' parameters: - name: X-Team-Id in: header description: 'Retrieve the Team ID from: https://cloud.projectdiscovery.io/settings/team' schema: type: string requestBody: $ref: '#/components/requestBodies/UpdateTemplateRequest' responses: '200': $ref: '#/components/responses/UpdateTemplateResponse' '400': $ref: '#/components/responses/MessageResponse' '401': $ref: '#/components/responses/MessageResponse' '500': $ref: '#/components/responses/MessageResponse' security: - X-API-Key: [] tags: - templates '/v1/template/{template_id}': parameters: - name: template_id in: path description: 'unique Id of template ' required: true schema: type: string get: operationId: get-v1-template-t_id summary: Get Template description: Get private template text using ID parameters: - name: X-Team-Id in: header description: 'Retrieve the Team ID from: https://cloud.projectdiscovery.io/settings/team' schema: type: string responses: '200': $ref: '#/components/responses/GetTemplateResponse' '400': $ref: '#/components/responses/GetTemplateResponse' '401': $ref: '#/components/responses/GetTemplateResponse' '404': $ref: '#/components/responses/MessageResponse' '500': $ref: '#/components/responses/GetTemplateResponse' security: - X-API-Key: [] tags: - templates delete: operationId: delete-v1-template-template_id summary: Delete Template description: Delete private template using ID parameters: - name: X-Team-Id in: header description: 'Retrieve the Team ID from: https://cloud.projectdiscovery.io/settings/team' schema: type: string responses: '200': $ref: '#/components/responses/DeleteTemplateResponse' '400': $ref: '#/components/responses/DeleteTemplateResponse' '401': $ref: '#/components/responses/DeleteTemplateResponse' '500': $ref: '#/components/responses/DeleteTemplateResponse' security: - X-API-Key: [] tags: - templates /v1/template/ai: post: operationId: post-v1-template-ai summary: Generate AI Template description: Generate a private template with AI Engine parameters: - name: X-Team-Id in: header description: 'Retrieve the Team ID from: https://cloud.projectdiscovery.io/settings/team' schema: type: string requestBody: $ref: '#/components/requestBodies/GenerateTemplateRequest' responses: '200': $ref: '#/components/responses/GenerateTemplateResponse' '400': $ref: '#/components/responses/GenerateTemplateResponse' '401': $ref: '#/components/responses/GenerateTemplateResponse' '403': $ref: '#/components/responses/GenerateTemplateResponse' '500': $ref: '#/components/responses/GenerateTemplateResponse' security: - X-API-Key: [] tags: - templates /v1/template/share: get: operationId: get-v1-template-share summary: Get Share Status description: Get template sahred status (shared-with-link) parameters: - name: template_id in: query description: short uuid of requested template required: true schema: type: string - name: user_name in: query description: user name of logged in user required: true schema: type: string - name: X-Team-Id in: header description: 'Retrieve the Team ID from: https://cloud.projectdiscovery.io/settings/team' schema: type: string responses: '200': $ref: '#/components/responses/GetShareStatusResponse' '400': $ref: '#/components/responses/GetShareStatusResponse' '401': $ref: '#/components/responses/GetShareStatusResponse' '404': $ref: '#/components/responses/GetShareStatusResponse' '500': $ref: '#/components/responses/GetShareStatusResponse' security: - X-API-Key: [] tags: - templates post: operationId: post-v1-template-share summary: Share Template description: Share a private template (shared-with-link) parameters: - name: X-Team-Id in: header description: 'Retrieve the Team ID from: https://cloud.projectdiscovery.io/settings/team' schema: type: string requestBody: $ref: '#/components/requestBodies/ShareTemplateRequest' responses: '200': $ref: '#/components/responses/ShareTemplateResponse' '400': $ref: '#/components/responses/ShareTemplateResponse' '401': $ref: '#/components/responses/ShareTemplateResponse' '404': $ref: '#/components/responses/ShareTemplateResponse' '500': $ref: '#/components/responses/ShareTemplateResponse' security: - X-API-Key: [] tags: - templates '/v1/template/share/{template_id}': parameters: - name: template_id in: path description: unique template ID required: true schema: type: string get: operationId: get-v1-template-share-template_id summary: Get Shared Template description: Get a shared template text parameters: - name: user_name in: query description: user name of template owner required: true schema: type: string - name: X-Team-Id in: header description: 'Retrieve the Team ID from: https://cloud.projectdiscovery.io/settings/team' schema: type: string responses: '200': $ref: '#/components/responses/GetSharedTemplateResponse' '400': $ref: '#/components/responses/GetSharedTemplateResponse' '401': $ref: '#/components/responses/GetSharedTemplateResponse' '404': $ref: '#/components/responses/GetSharedTemplateResponse' '500': $ref: '#/components/responses/GetSharedTemplateResponse' tags: - templates /v1/scans/scan_ips: get: operationId: get-v1-scans-scan_ips summary: Get Scan IPs description: Get list of static IPs used for scan parameters: - name: X-Team-Id in: header description: 'Retrieve the Team ID from: https://cloud.projectdiscovery.io/settings/team' schema: type: string responses: '200': $ref: '#/components/responses/StaticScanIPsResponse' '400': $ref: '#/components/responses/ErrorResponse' '401': $ref: '#/components/responses/ErrorResponse' '403': $ref: '#/components/responses/ErrorResponse' '500': $ref: '#/components/responses/ErrorResponse' default: $ref: '#/components/responses/ErrorResponse' security: - X-API-Key: [] tags: - scans '/v1/scans/{scan_id}/import': parameters: - name: scan_id in: path required: true schema: type: string patch: operationId: patch-v1-scans-scan_id-import summary: Update Imported Scan description: Import more results to a given scan parameters: - name: X-Team-Id in: header description: 'Retrieve the Team ID from: https://cloud.projectdiscovery.io/settings/team' schema: type: string requestBody: content: application/octet-stream: schema: type: string format: binary responses: '200': $ref: '#/components/responses/MessageResponse' '401': $ref: '#/components/responses/ErrorResponse' '403': $ref: '#/components/responses/ErrorResponse' '500': $ref: '#/components/responses/ErrorResponse' default: $ref: '#/components/responses/ErrorResponse' security: - X-API-Key: [] tags: - scans '/v1/scans/{scan_id}/export': parameters: - name: scan_id in: path required: true schema: type: string - name: async in: query schema: type: boolean get: operationId: get-v1-scans-scan_id-export summary: Export Scan description: Export scan results parameters: - name: type in: query description: 'json, csv, pdf (default json)' schema: type: string enum: - json - csv - pdf - name: X-Team-Id in: header description: 'Retrieve the Team ID from: https://cloud.projectdiscovery.io/settings/team' schema: type: string responses: '200': description: OK content: application/octet-stream: schema: type: string '201': description: Created content: application/json: schema: type: object properties: export_id: type: string required: - export_id '401': $ref: '#/components/responses/ErrorResponse' '403': $ref: '#/components/responses/ErrorResponse' '500': $ref: '#/components/responses/ErrorResponse' default: $ref: '#/components/responses/ErrorResponse' security: - X-API-Key: [] tags: - scans post: operationId: post-v1-scans-scan_id-export summary: Export Filtered Scan description: Export filtered scan results parameters: - name: type in: query description: 'json, csv, pdf (default json)' schema: type: string enum: - json - csv - pdf - name: X-Team-Id in: header description: 'Retrieve the Team ID from: https://cloud.projectdiscovery.io/settings/team' schema: type: string requestBody: content: application/json: schema: type: object properties: ids: type: array items: type: string vuln_status: type: string severity: type: array items: type: string host: type: array items: type: string template: type: array items: type: string search: type: string responses: '200': description: OK content: application/octet-stream: schema: type: string '201': description: Created content: application/json: schema: type: object properties: export_id: type: string required: - export_id '401': $ref: '#/components/responses/ErrorResponse' '403': $ref: '#/components/responses/ErrorResponse' '500': $ref: '#/components/responses/ErrorResponse' default: $ref: '#/components/responses/ErrorResponse' security: - X-API-Key: [] tags: - scans /v1/scans/results/export: parameters: - name: async in: query schema: type: boolean post: operationId: post-v1-scans-results-export summary: Export filtered Scan results description: Export filtered scan results parameters: - name: type in: query description: 'json, csv, pdf (default json)' schema: type: string enum: - json - csv - pdf - name: X-Team-Id in: header description: 'Retrieve the Team ID from: https://cloud.projectdiscovery.io/settings/team' schema: type: string requestBody: content: application/json: schema: type: object properties: ids: type: array items: type: string vuln_status: type: string severity: type: array items: type: string host: type: array items: type: string template: type: array items: type: string search: type: string scan_ids: type: array items: type: string responses: '200': description: OK content: application/octet-stream: schema: type: string '201': description: Created content: application/json: schema: type: object properties: export_id: type: string required: - export_id '401': $ref: '#/components/responses/ErrorResponse' '403': $ref: '#/components/responses/ErrorResponse' '500': $ref: '#/components/responses/ErrorResponse' default: $ref: '#/components/responses/ErrorResponse' security: - X-API-Key: [] tags: - export /v1/export/list: get: operationId: get-v1-export-list summary: Get export list for user parameters: - name: offset in: query description: The number of items to skip before starting to collect the result set schema: type: integer - name: limit in: query schema: type: integer - name: export_status in: query schema: type: string - name: X-Team-Id in: header description: 'Retrieve the Team ID from: https://cloud.projectdiscovery.io/settings/team' schema: type: string responses: '200': description: OK content: application/json: schema: type: object properties: current_page: type: integer result_count: type: integer total_results: type: integer total_pages: type: integer data: type: array items: $ref: '#/components/schemas/ExportListItem' required: - current_page - result_count - total_results - total_pages - data '401': $ref: '#/components/responses/ErrorResponse' '403': $ref: '#/components/responses/ErrorResponse' '500': $ref: '#/components/responses/ErrorResponse' default: $ref: '#/components/responses/ErrorResponse' tags: - export '/v1/scans/vuln/{vuln_id}/export': parameters: - name: vuln_id in: path required: true schema: type: string get: operationId: get-v1-scans-vuln-vuln_id-export summary: Export Scan Vulnerability description: Export a specific scan vulnerability parameters: - name: type in: query description: 'json, csv (default json)' schema: type: string enum: - json - csv - name: X-Team-Id in: header description: 'Retrieve the Team ID from: https://cloud.projectdiscovery.io/settings/team' schema: type: string responses: '200': description: OK content: application/octet-stream: schema: type: string '401': $ref: '#/components/responses/ErrorResponse' '403': $ref: '#/components/responses/ErrorResponse' '500': $ref: '#/components/responses/ErrorResponse' default: $ref: '#/components/responses/ErrorResponse' security: - X-API-Key: [] tags: - scans /v1/scans/vulns: patch: operationId: patch-v1-scans-vulns summary: Update Vulnerability Status description: Batch update vulnerability status parameters: - name: X-Team-Id in: header description: 'Retrieve the Team ID from: https://cloud.projectdiscovery.io/settings/team' schema: type: string requestBody: $ref: '#/components/requestBodies/PatchScanVulnsRequest' responses: '200': $ref: '#/components/responses/MessageResponse' '400': $ref: '#/components/responses/ErrorResponse' '401': $ref: '#/components/responses/ErrorResponse' '500': $ref: '#/components/responses/ErrorResponse' default: $ref: '#/components/responses/ErrorResponse' security: - X-API-Key: [] tags: - scans delete: operationId: delete-v1-scans-vulns summary: Delete Scan Vulnerability description: Batch Delete scan vulnerability parameters: - name: X-Team-Id in: header description: 'Retrieve the Team ID from: https://cloud.projectdiscovery.io/settings/team' schema: type: string requestBody: $ref: '#/components/requestBodies/DeleteVulnsRequest' responses: '200': $ref: '#/components/responses/MessageResponse' '400': $ref: '#/components/responses/ErrorResponse' '401': $ref: '#/components/responses/ErrorResponse' '500': $ref: '#/components/responses/ErrorResponse' default: $ref: '#/components/responses/ErrorResponse' security: - X-API-Key: [] tags: - scans /v1/scans/vulns/labels: patch: operationId: patch-v1-scans-vulns-labels summary: Update Vulnerability Labels description: Batch update vulnerability labels parameters: - name: X-Team-Id in: header description: 'Retrieve the Team ID from: https://cloud.projectdiscovery.io/settings/team' schema: type: string requestBody: $ref: '#/components/requestBodies/PatchScanVulnsLabelsRequest' responses: '200': $ref: '#/components/responses/MessageResponse' '400': $ref: '#/components/responses/ErrorResponse' '401': $ref: '#/components/responses/ErrorResponse' '500': $ref: '#/components/responses/ErrorResponse' default: $ref: '#/components/responses/ErrorResponse' security: - X-API-Key: [] tags: - scans /v1/scans/config: get: operationId: get-v1-scans-config summary: Get Configs List description: Get user scan configurations list parameters: - name: type in: query description: filter by the type of config schema: type: string enum: - scan - reporting - template - alerting - cloudlist - name: search in: query description: search by config name schema: type: string - name: limit in: query description: The numbers of items to return schema: type: integer - name: offset in: query description: The number of items to skip before starting to collect the result set schema: type: integer - name: X-Team-Id in: header description: 'Retrieve the Team ID from: https://cloud.projectdiscovery.io/settings/team' schema: type: string responses: '200': description: OK content: application/json: schema: type: array items: $ref: '#/components/schemas/ConfigResponse' '400': $ref: '#/components/responses/ErrorResponse' '401': $ref: '#/components/responses/ErrorResponse' '403': $ref: '#/components/responses/ErrorResponse' '500': $ref: '#/components/responses/ErrorResponse' default: $ref: '#/components/responses/ErrorResponse' security: - X-API-Key: [] tags: - configurations post: operationId: post-v1-scans-config summary: Add Config description: Add a new scan configuration parameters: - name: X-Team-Id in: header description: 'Retrieve the Team ID from: https://cloud.projectdiscovery.io/settings/team' schema: type: string requestBody: content: application/json: schema: type: object properties: config: type: string config_type: $ref: '#/components/schemas/ConfigTypeEnum' name: type: string global: type: boolean required: - config - name responses: '200': $ref: '#/components/responses/PostScanConfigResponse' '400': $ref: '#/components/responses/ErrorResponse' '401': $ref: '#/components/responses/ErrorResponse' '403': $ref: '#/components/responses/ErrorResponse' '500': $ref: '#/components/responses/ErrorResponse' default: $ref: '#/components/responses/ErrorResponse' security: - X-API-Key: [] tags: - configurations '/v1/scans/config/{config_id}': parameters: - name: config_id in: path required: true schema: type: string get: operationId: get-v1-scans-config-config_id summary: Get Config description: Get a scan configuration parameters: - name: X-Team-Id in: header description: 'Retrieve the Team ID from: https://cloud.projectdiscovery.io/settings/team' schema: type: string responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/ConfigResponse' '400': $ref: '#/components/responses/ErrorResponse' '401': $ref: '#/components/responses/ErrorResponse' '403': $ref: '#/components/responses/ErrorResponse' '500': $ref: '#/components/responses/ErrorResponse' default: $ref: '#/components/responses/ErrorResponse' security: - X-API-Key: [] tags: - configurations patch: operationId: patch-v1-scans-config-config_id summary: Update Config description: Update existing scan configuration parameters: - name: X-Team-Id in: header description: 'Retrieve the Team ID from: https://cloud.projectdiscovery.io/settings/team' schema: type: string requestBody: content: application/json: schema: type: object properties: name: type: string config: type: string global: type: boolean responses: '200': $ref: '#/components/responses/PostScanConfigResponse' '400': $ref: '#/components/responses/ErrorResponse' '401': $ref: '#/components/responses/ErrorResponse' '403': $ref: '#/components/responses/ErrorResponse' '500': $ref: '#/components/responses/ErrorResponse' default: $ref: '#/components/responses/ErrorResponse' security: - X-API-Key: [] tags: - configurations delete: operationId: delete-v1-scans-config-config_id summary: Delete Config description: Delete scan configuration parameters: - name: X-Team-Id in: header description: 'Retrieve the Team ID from: https://cloud.projectdiscovery.io/settings/team' schema: type: string responses: '200': $ref: '#/components/responses/MessageResponse' '400': $ref: '#/components/responses/ErrorResponse' '401': $ref: '#/components/responses/ErrorResponse' '403': $ref: '#/components/responses/ErrorResponse' '500': $ref: '#/components/responses/ErrorResponse' default: $ref: '#/components/responses/ErrorResponse' security: - X-API-Key: [] tags: - configurations /v1/scans/config/verify: post: operationId: post-v1-scans-config-verify summary: Verify Config description: Verify scan configuration parameters: - name: X-Team-Id in: header description: 'Retrieve the Team ID from: https://cloud.projectdiscovery.io/settings/team' schema: type: string requestBody: $ref: '#/components/requestBodies/VerifyConfigRequest' responses: '200': $ref: '#/components/responses/VerifyConfigResponse' '400': $ref: '#/components/responses/ErrorResponse' '401': $ref: '#/components/responses/ErrorResponse' '500': $ref: '#/components/responses/ErrorResponse' default: $ref: '#/components/responses/ErrorResponse' security: - X-API-Key: [] tags: - configurations /v1/scans/config/verify/contents: post: operationId: post-v1-scans-config-verify-contents summary: Get Verify Config Contents description: Get Verify scan configuration contents parameters: - name: X-Team-Id in: header description: 'Retrieve the Team ID from: https://cloud.projectdiscovery.io/settings/team' schema: type: string requestBody: $ref: '#/components/requestBodies/VerifyConfigContentsRequest' responses: '200': $ref: '#/components/responses/VerifyConfigContentsResponse' '400': $ref: '#/components/responses/ErrorResponse' '401': $ref: '#/components/responses/ErrorResponse' '500': $ref: '#/components/responses/ErrorResponse' default: $ref: '#/components/responses/ErrorResponse' security: - X-API-Key: [] tags: - configurations '/v1/scans/{scan_id}/config': parameters: - name: scan_id in: path required: true schema: type: string get: operationId: get-scans-id-config summary: Get Scan Config description: 'Get scan metadata config ' parameters: - name: X-Team-Id in: header description: 'Retrieve the Team ID from: https://cloud.projectdiscovery.io/settings/team' schema: type: string responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/ScanConfig' '400': $ref: '#/components/responses/ErrorResponse' '401': $ref: '#/components/responses/ErrorResponse' '500': $ref: '#/components/responses/ErrorResponse' default: $ref: '#/components/responses/ErrorResponse' security: - X-API-Key: [] tags: - scans patch: operationId: patch-scans-id-config summary: Update Scan Config description: Update scan metadata config parameters: - name: update_type in: query description: 'Update type: append or replace' schema: type: string default: append enum: - append - replace - name: X-Team-Id in: header description: 'Retrieve the Team ID from: https://cloud.projectdiscovery.io/settings/team' schema: type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/ScanConfigUpdateItem' responses: '200': description: OK content: application/json: schema: type: object properties: ok: type: boolean '400': $ref: '#/components/responses/ErrorResponse' '401': $ref: '#/components/responses/ErrorResponse' '500': $ref: '#/components/responses/ErrorResponse' default: $ref: '#/components/responses/ErrorResponse' security: - X-API-Key: [] tags: - scans /v1/user/subscription: get: operationId: get-v1-user-subscription summary: Get Subscription Status description: Get user subscription status parameters: - name: X-Team-Id in: header description: 'Retrieve the Team ID from: https://cloud.projectdiscovery.io/settings/team' schema: type: string responses: '200': description: OK content: application/json: schema: type: object properties: status: type: string message: type: string amount: type: integer monthly_token: type: integer price_id: type: string recurrence: type: string from: type: string to: type: string card: type: string brand: type: string payment_mode: type: string cancel_at: type: string trial: type: string required: - status - message '400': description: Bad Request content: application/json: schema: type: object properties: message: type: string required: - message '500': description: Internal Server Error content: application/json: schema: type: object properties: message: type: string required: - message security: - X-API-Key: [] tags: - users patch: operationId: patch-v1-user-subscription summary: Update current subscription parameters: - name: X-Team-Id in: header description: 'Retrieve the Team ID from: https://cloud.projectdiscovery.io/settings/team' schema: type: string requestBody: content: application/json: schema: type: object properties: price_id: type: string required: - price_id responses: '200': description: OK content: application/json: schema: type: object properties: message: type: string invoice: type: string status: type: string required: - message - status '400': $ref: '#/components/responses/MessageResponse' '403': $ref: '#/components/responses/MessageResponse' '500': $ref: '#/components/responses/MessageResponse' security: - X-API-Key: [] tags: - users /v1/asset/enumerate: get: operationId: get-v1-asset-enumerate summary: Get Enumeration List description: Get enumeration list parameters: - name: offset in: query description: The number of items to skip before starting to collect the result set schema: type: integer - name: limit in: query description: The numbers of items to return schema: type: integer - name: search in: query description: search keyword in enumeration list schema: type: string - name: enum_type in: query description: types of enumeration list (comma seperated) schema: type: string - name: sort_asc in: query description: 'comma separated ascending sorting e.g sort_asc=created_at,name' schema: type: string - name: sort_desc in: query description: 'comma separated descending sorting e.g sort_desc=created_at,name' schema: type: string - name: status in: query description: comma separated filter enumeration result by status schema: type: string - name: X-Team-Id in: header description: 'Retrieve the Team ID from: https://cloud.projectdiscovery.io/settings/team' schema: type: string responses: '200': $ref: '#/components/responses/EnumerateResponse' '400': $ref: '#/components/responses/ErrorResponse' '401': $ref: '#/components/responses/ErrorResponse' '403': $ref: '#/components/responses/ErrorResponse' '500': $ref: '#/components/responses/ErrorResponse' default: $ref: '#/components/responses/ErrorResponse' security: - X-API-Key: [] tags: - enumerations post: operationId: post-v1-asset-enumerate summary: Create Enumeration description: Create a new enumeration parameters: - name: X-Team-Id in: header description: 'Retrieve the Team ID from: https://cloud.projectdiscovery.io/settings/team' schema: type: string requestBody: content: application/json: schema: type: object properties: root_domains: type: array items: type: string enrichment_inputs: type: array items: type: string cloudlist_config_ids: type: array items: type: string name: type: string steps: type: array items: type: string enum: - dns_passive - dns_resolve - dns_bruteforce - dns_permute - port_scan - http_probe - http_screenshot enumeration_ports: type: string alerting_config_ids: type: array items: type: string disable_global_alert_config: type: boolean exclude_targets: type: array items: type: string enumeration_config: type: object properties: follow-redirect: type: boolean ports: type: string responses: '200': description: OK content: application/json: schema: type: object properties: id: type: string truncated-scan-targets: type: integer required: - id '400': $ref: '#/components/responses/ErrorResponse' '401': $ref: '#/components/responses/ErrorResponse' '403': $ref: '#/components/responses/ErrorResponse' '500': $ref: '#/components/responses/ErrorResponse' default: $ref: '#/components/responses/ErrorResponse' security: - X-API-Key: [] tags: - enumerations delete: operationId: delete-v1-asset-enumerates summary: Delete Bulk Enumeration description: Delete enumeration by enumerate ids parameters: - name: X-Team-Id in: header description: 'Retrieve the Team ID from: https://cloud.projectdiscovery.io/settings/team' schema: type: string requestBody: content: application/json: schema: type: object properties: asset_ids: type: array items: type: string required: - asset_ids responses: '200': $ref: '#/components/responses/MessageResponse' '400': $ref: '#/components/responses/ErrorResponse' '401': $ref: '#/components/responses/ErrorResponse' '500': $ref: '#/components/responses/ErrorResponse' default: $ref: '#/components/responses/ErrorResponse' security: - X-API-Key: [] tags: - enumerations '/v1/asset/enumerate/{enumerate_id}': parameters: - name: enumerate_id in: path required: true schema: type: string get: operationId: get-v1-asset-enumerate-enumerate_id summary: Get Enumeration description: Get enumeration by enumerate_id parameters: - name: X-Team-Id in: header description: 'Retrieve the Team ID from: https://cloud.projectdiscovery.io/settings/team' schema: type: string responses: '200': $ref: '#/components/responses/GetEnumerateIdContentsResponse' '400': $ref: '#/components/responses/ErrorResponse' '401': $ref: '#/components/responses/ErrorResponse' '403': $ref: '#/components/responses/ErrorResponse' '499': $ref: '#/components/responses/ErrorResponse' '500': $ref: '#/components/responses/ErrorResponse' default: $ref: '#/components/responses/ErrorResponse' security: - X-API-Key: [] tags: - enumerations patch: operationId: patch-v1-asset-enumerate-enumerate_id summary: Update Enumeration description: Update enumeration by enumerate_id parameters: - name: X-Team-Id in: header description: 'Retrieve the Team ID from: https://cloud.projectdiscovery.io/settings/team' schema: type: string requestBody: content: application/json: schema: type: object properties: name: type: string responses: '200': $ref: '#/components/responses/MessageResponse' '400': $ref: '#/components/responses/ErrorResponse' '401': $ref: '#/components/responses/ErrorResponse' '403': $ref: '#/components/responses/ErrorResponse' '500': $ref: '#/components/responses/ErrorResponse' default: $ref: '#/components/responses/ErrorResponse' security: - X-API-Key: [] tags: - enumerations delete: operationId: delete-v1-asset-enumerate-enumerate_id summary: Delete Enumeration description: Delete enumeration by enumerate_id parameters: - name: X-Team-Id in: header description: 'Retrieve the Team ID from: https://cloud.projectdiscovery.io/settings/team' schema: type: string responses: '200': $ref: '#/components/responses/MessageResponse' '400': $ref: '#/components/responses/ErrorResponse' '401': $ref: '#/components/responses/ErrorResponse' '500': $ref: '#/components/responses/ErrorResponse' default: $ref: '#/components/responses/ErrorResponse' security: - X-API-Key: [] tags: - enumerations '/v1/asset/enumerate/{enumerate_id}/contents': parameters: - name: enumerate_id in: path required: true schema: type: string get: operationId: get-v1-asset-enumerate-enumerate_id-contents summary: Get Enumeration Contents description: Get enumeration content by enumerate_id parameters: - name: offset in: query description: The number of items to skip before starting to collect the result set schema: type: integer default: 0 - name: limit in: query description: The numbers of items to return schema: type: integer default: 100 - name: is_tech in: query description: Return records that have technologies schema: type: boolean - name: is_favicon in: query description: Return the records that have favicon schema: type: boolean - name: search in: query description: Search on the content name schema: type: string - name: labels in: query description: 'Filter by comma separated labels, e.g-> labels=p1,p2' schema: type: string - name: is_new in: query description: Filter by new content schema: type: boolean - name: host in: query description: 'Filter by comma separated labels, e.g-> host=p1,p2' schema: type: string - name: port in: query description: 'Filter by port separated labels, e.g-> port=p1,p2' schema: type: string - name: status_code in: query description: 'Filter by status code separated labels, e.g-> status_code=p1,p2' schema: type: string - name: title in: query description: 'Filter by title separated labels, e.g-> title=p1,p2' schema: type: string - name: content_length in: query description: 'Filter by content length separated labels, e.g-> content_length=p1,p2' schema: type: string - name: cname in: query description: cname to filter schema: type: string - name: domain in: query description: 'Filter by domain names separated labels, e.g-> domain=domain1.com,domain2.com' schema: type: string - name: technologies in: query description: technologies to filter schema: type: string - name: ip in: query description: ips to filter schema: type: string - name: sort_asc in: query description: 'comma separated ascending sorting e.g sort_asc=created_at,name' schema: type: string - name: sort_desc in: query description: 'comma separated descending sorting e.g sort_desc=created_at,name' schema: type: string - name: is_screenshot in: query description: asset with screenshots schema: type: boolean - name: time in: query description: time filter to select schema: default: all_time $ref: '#/components/schemas/TimeRangeQueryParameter' - name: start_date in: query description: time filter start date schema: type: string format: date - name: end_date in: query description: time filter end date schema: type: string format: date - name: X-Team-Id in: header description: 'Retrieve the Team ID from: https://cloud.projectdiscovery.io/settings/team' schema: type: string responses: '200': $ref: '#/components/responses/GetEnumerateIdContents' '400': $ref: '#/components/responses/ErrorResponse' '401': $ref: '#/components/responses/ErrorResponse' '403': $ref: '#/components/responses/ErrorResponse' '500': $ref: '#/components/responses/ErrorResponse' default: $ref: '#/components/responses/ErrorResponse' security: - X-API-Key: [] tags: - enumerations /v1/asset/enumerate/contents: get: operationId: get-v1-asset-enumerate-contents summary: Get All Enumeration Contents description: Get All enumeration content parameters: - name: offset in: query description: The number of items to skip before starting to collect the result set schema: type: integer default: 0 - name: limit in: query description: The numbers of items to return schema: type: integer default: 100 - name: is_tech in: query description: Return records that have technologies schema: type: boolean - name: is_favicon in: query description: Return the records that have favicon schema: type: boolean - name: search in: query description: Search on the content name schema: type: string - name: labels in: query description: 'Filter by comma separated labels, e.g-> labels=p1,p2' schema: type: string - name: is_new in: query description: Filter by new content schema: type: boolean - name: host in: query description: 'Filter by comma separated labels, e.g-> host=p1,p2' schema: type: string - name: port in: query description: 'Filter by port separated labels, e.g-> port=p1,p2' schema: type: string - name: status_code in: query description: 'Filter by status code separated labels, e.g-> status_code=p1,p2' schema: type: string - name: title in: query description: 'Filter by title separated labels, e.g-> title=p1,p2' schema: type: string - name: content_length in: query description: 'Filter by content length separated labels, e.g-> content_length=p1,p2' schema: type: string - name: domain in: query description: 'Filter by domain names separated labels, e.g-> domain=domain1.com,domain2.com' schema: type: string - name: cname in: query description: cname to filter schema: type: string - name: technologies in: query description: technologies to filter schema: type: string - name: ip in: query description: ips to filter schema: type: string - name: sort_asc in: query description: 'comma separated ascending sorting e.g sort_asc=created_at,name' schema: type: string - name: sort_desc in: query description: 'comma separated descending sorting e.g sort_desc=created_at,name' schema: type: string - name: X-Team-Id in: header description: 'Retrieve the Team ID from: https://cloud.projectdiscovery.io/settings/team' schema: type: string responses: '200': $ref: '#/components/responses/GetEnumerateIdContents' '400': $ref: '#/components/responses/ErrorResponse' '401': $ref: '#/components/responses/ErrorResponse' '403': $ref: '#/components/responses/ErrorResponse' '500': $ref: '#/components/responses/ErrorResponse' default: $ref: '#/components/responses/ErrorResponse' security: - X-API-Key: [] tags: - enumerations '/v1/asset/enumerate/{enumerate_id}/stop': parameters: - name: enumerate_id in: path required: true schema: type: string post: operationId: post-v1-asset-enumerate-enumerate_id-stop summary: Stop Enumeration description: Stop a running enumeration parameters: - name: X-Team-Id in: header description: 'Retrieve the Team ID from: https://cloud.projectdiscovery.io/settings/team' schema: type: string responses: '200': $ref: '#/components/responses/MessageResponse' '400': $ref: '#/components/responses/ErrorResponse' '401': $ref: '#/components/responses/ErrorResponse' '500': $ref: '#/components/responses/ErrorResponse' default: $ref: '#/components/responses/ErrorResponse' security: - X-API-Key: [] tags: - enumerations '/v1/asset/enumerate/{enumerate_id}/rescan': parameters: - name: enumerate_id in: path required: true schema: type: string post: operationId: post-v1-asset-enumerate-enumerate_id-rescan summary: Rescan Enumeration description: Re-run a existing enumeration parameters: - name: X-Team-Id in: header description: 'Retrieve the Team ID from: https://cloud.projectdiscovery.io/settings/team' schema: type: string responses: '200': description: OK content: application/json: schema: type: object properties: id: type: string truncated-scan-targets: type: integer required: - id '400': $ref: '#/components/responses/ErrorResponse' '401': $ref: '#/components/responses/ErrorResponse' '403': $ref: '#/components/responses/ErrorResponse' '500': $ref: '#/components/responses/ErrorResponse' default: $ref: '#/components/responses/ErrorResponse' security: - X-API-Key: [] tags: - enumerations '/v1/asset/enumerate/{enum_id}/export': parameters: - name: enum_id in: path required: true schema: type: string - name: async in: query schema: type: boolean get: operationId: get-enumerate-id-export summary: Export Enumeration description: Export enumeration content parameters: - name: format in: query schema: $ref: '#/components/schemas/EnumExportFormats' - name: search in: query description: Search by string schema: type: string - name: labels in: query description: 'Filter by comma separated labels, e.g-> labels=p1,p2' schema: type: string - name: is_new in: query description: Filter by new content schema: type: boolean - name: host in: query description: 'Filter by comma separated labels, e.g-> host=p1,p2' schema: type: string - name: port in: query description: 'Filter by port separated labels, e.g-> port=p1,p2' schema: type: string - name: status_code in: query description: 'Filter by status code separated labels, e.g-> status_code=p1,p2' schema: type: string - name: title in: query description: 'Filter by title separated labels, e.g-> title=p1,p2' schema: type: string - name: content_length in: query description: 'Filter by content length separated labels, e.g-> content_length=p1,p2' schema: type: string - name: cname in: query description: cname to filter schema: type: string - name: technologies in: query description: technologies to filter schema: type: string - name: ip in: query description: ips to filter schema: type: string - name: X-Team-Id in: header description: 'Retrieve the Team ID from: https://cloud.projectdiscovery.io/settings/team' schema: type: string responses: '200': description: OK content: application/octet-stream: schema: type: string '201': description: Created content: application/json: schema: type: object properties: export_id: type: string required: - export_id '400': $ref: '#/components/responses/ErrorResponse' '401': $ref: '#/components/responses/ErrorResponse' '500': $ref: '#/components/responses/ErrorResponse' default: $ref: '#/components/responses/ErrorResponse' security: - X-API-Key: [] tags: - enumerations /v1/enumeration/schedule: get: operationId: get-v1-enumeration-schedule summary: Get Enumeration Schedules description: Get enumeration re-scan schedule parameters: - name: X-Team-Id in: header description: 'Retrieve the Team ID from: https://cloud.projectdiscovery.io/settings/team' schema: type: string responses: '200': $ref: '#/components/responses/GetEnumerationScheduleResponse' '400': $ref: '#/components/responses/MessageResponse' '401': $ref: '#/components/responses/MessageResponse' '500': $ref: '#/components/responses/MessageResponse' security: - X-API-Key: [] tags: - enumerations post: operationId: post-v1-enumeration-schedule summary: Set Enumeration Schedule description: Set enumeration re-scan frequency parameters: - name: X-Team-Id in: header description: 'Retrieve the Team ID from: https://cloud.projectdiscovery.io/settings/team' schema: type: string requestBody: $ref: '#/components/requestBodies/SetEnumerationScheduleRequest' responses: '200': $ref: '#/components/responses/MessageResponse' '400': $ref: '#/components/responses/MessageResponse' '401': $ref: '#/components/responses/MessageResponse' '500': $ref: '#/components/responses/MessageResponse' default: $ref: '#/components/responses/ErrorResponse' security: - X-API-Key: [] tags: - enumerations delete: operationId: delete-v1-enumeration-schedule summary: Delete Enumeration Schedule description: Delete a re-scan schedule parameters: - name: enumeration_id in: query description: enumeration_id of the schedule to be deleted required: true schema: type: string - name: X-Team-Id in: header description: 'Retrieve the Team ID from: https://cloud.projectdiscovery.io/settings/team' schema: type: string responses: '200': $ref: '#/components/responses/MessageResponse' '400': $ref: '#/components/responses/MessageResponse' '401': $ref: '#/components/responses/MessageResponse' '500': $ref: '#/components/responses/MessageResponse' default: $ref: '#/components/responses/ErrorResponse' security: - X-API-Key: [] tags: - enumerations /v1/team/audit_log: get: operationId: get-v1-audit-log summary: Get audit logs for team parameters: - name: email in: query description: filter by specific user schema: type: string - name: action in: query description: filter by specific action name schema: type: string - name: offset in: query description: number of rows to skip schema: type: integer - name: limit in: query description: number of rows to get schema: type: integer - name: start_date in: query description: start date from which you want to get logs schema: type: string format: date - name: end_date in: query description: end date till which you want to get logs schema: type: string format: date - name: time_range in: query description: time range to get logs schema: type: string enum: - current_month - last_month - last_3_months - last_6_months - last_12_months - name: X-Team-Id in: header description: 'Retrieve the Team ID from: https://cloud.projectdiscovery.io/settings/team' schema: type: string responses: '200': description: OK content: application/json: schema: type: object properties: message: type: string data: type: array items: $ref: '#/components/schemas/UserAuditLogItems' required: - message - data '400': $ref: '#/components/responses/MessageResponse' '401': $ref: '#/components/responses/MessageResponse' '500': $ref: '#/components/responses/MessageResponse' security: - X-API-Key: [] tags: [] /v1/scans/history: get: operationId: get-v1-scans-history summary: Get All Scans History description: Get user scan history details parameters: - name: offset in: query description: number of rows to skip schema: type: integer - name: limit in: query description: number of rows to get schema: type: integer - name: start_date in: query description: start date from which you want to get history schema: type: string format: date - name: end_date in: query description: end date till which you want to get history schema: type: string format: date - name: time_range in: query description: time range to get history schema: type: string enum: - current_month - last_month - last_3_months - last_6_months - last_12_months - all_time - name: X-Team-Id in: header description: 'Retrieve the Team ID from: https://cloud.projectdiscovery.io/settings/team' schema: type: string responses: '200': $ref: '#/components/responses/GetScansHistoryResponse' '400': $ref: '#/components/responses/ErrorResponse' '401': $ref: '#/components/responses/ErrorResponse' '500': $ref: '#/components/responses/ErrorResponse' default: $ref: '#/components/responses/ErrorResponse' security: - X-API-Key: [] tags: - scans '/v1/scans/{scanId}/history': parameters: - name: scanId in: path required: true schema: type: string get: operationId: get-v1-scans-scanId-history summary: Get Scan History description: Get scan history detial by scanId parameters: - name: offset in: query description: number of rows to skip schema: type: integer - name: limit in: query description: number of rows to get schema: type: integer - name: start_date in: query description: start date from which you want to get history schema: type: string format: date - name: end_date in: query description: end date till which you want to get history schema: type: string format: date - name: time_range in: query description: time range to get history schema: type: string enum: - current_month - last_month - last_3_months - last_6_months - last_12_months - all_time - name: X-Team-Id in: header description: 'Retrieve the Team ID from: https://cloud.projectdiscovery.io/settings/team' schema: type: string responses: '200': $ref: '#/components/responses/GetScansHistoryResponse' '400': $ref: '#/components/responses/ErrorResponse' '401': $ref: '#/components/responses/ErrorResponse' '500': $ref: '#/components/responses/ErrorResponse' default: $ref: '#/components/responses/ErrorResponse' security: - X-API-Key: [] tags: - scans /v1/template/github: get: operationId: get-v1-github-templates summary: Get Github Template List description: List of all user's github templates parameters: - name: X-Team-Id in: header description: 'Retrieve the Team ID from: https://cloud.projectdiscovery.io/settings/team' schema: type: string responses: '200': description: OK content: application/json: schema: type: object properties: data: type: array items: $ref: '#/components/schemas/GithubTemplateListItem' required: - data '400': $ref: '#/components/responses/MessageResponse' '401': $ref: '#/components/responses/MessageResponse' '500': $ref: '#/components/responses/MessageResponse' security: - X-API-Key: [] tags: - templates parameters: [] '/v1/template/github/{id}': parameters: - name: id in: path required: true schema: type: string get: operationId: get-v1-github-templates-id summary: Get Github Template description: Get github template text parameters: - name: X-Team-Id in: header description: 'Retrieve the Team ID from: https://cloud.projectdiscovery.io/settings/team' schema: type: string responses: '200': description: OK content: text/plain: schema: type: string '400': $ref: '#/components/responses/MessageResponse' '404': $ref: '#/components/responses/MessageResponse' '500': $ref: '#/components/responses/MessageResponse' security: - X-API-Key: [] tags: - templates /v1/template/stats: get: operationId: get-v1-template-stats summary: Get Public Template Stats description: Get public template statistics parameters: - name: from in: query description: define result number to return from schema: type: integer - name: size in: query description: define number of results to return schema: type: integer - name: q in: query description: query string to match against all response value schema: type: string - name: fq in: query description: define specific field to query schema: type: string - name: fl in: query description: define specific field to return schema: type: string - name: sort_by in: query description: sort response value based on given key schema: type: string - name: sort_dir in: query description: sort direction for given key schema: type: string responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/TemplateStats' '400': $ref: '#/components/responses/MessageResponse' '401': $ref: '#/components/responses/MessageResponse' '500': $ref: '#/components/responses/MessageResponse' security: - X-API-Key: [] tags: - templates '/v1/scans/{scan_id}/error_log': parameters: - name: scan_id in: path required: true schema: type: string get: operationId: get-scans-id-elog summary: Get elogs of given scan id parameters: - name: host in: query description: target to search in log schema: type: string - name: template in: query description: template to search in log schema: type: string - name: matched in: query description: status to search in log schema: type: string - name: time in: query description: time to filter the logs schema: type: string format: date-time - name: search in: query description: 'string to search in error, target and template' schema: type: string - name: error in: query description: error to search in log schema: type: string - name: next_page_token in: query description: next page token schema: type: string - name: X-Team-Id in: header description: 'Retrieve the Team ID from: https://cloud.projectdiscovery.io/settings/team' schema: type: string responses: '200': description: OK content: application/json: schema: type: object properties: logs: type: array items: $ref: '#/components/schemas/ScanLogResp' next_page_token: type: string required: - logs - next_page_token '400': $ref: '#/components/responses/ErrorResponse' '401': $ref: '#/components/responses/ErrorResponse' '500': $ref: '#/components/responses/ErrorResponse' default: $ref: '#/components/responses/ErrorResponse' tags: - elog '/v1/scans/{scan_id}/scan_log': parameters: - name: scan_id in: path required: true schema: type: string get: operationId: get-scans-id-scan-log summary: Get scan log of given scan id parameters: - name: host in: query description: target to search in log schema: type: string - name: template in: query description: template to search in log schema: type: string - name: matched in: query description: status to search in log schema: type: string - name: time in: query description: time to filter the logs schema: type: string format: date-time - name: search in: query description: 'string to search in error, target and template' schema: type: string - name: next_page_token in: query schema: type: string - name: X-Team-Id in: header description: 'Retrieve the Team ID from: https://cloud.projectdiscovery.io/settings/team' schema: type: string responses: '200': description: OK content: application/json: schema: type: object properties: logs: type: array items: $ref: '#/components/schemas/ScanLogResp' next_page_token: type: string required: - logs - next_page_token '400': $ref: '#/components/responses/ErrorResponse' '401': $ref: '#/components/responses/ErrorResponse' '500': $ref: '#/components/responses/ErrorResponse' default: $ref: '#/components/responses/ErrorResponse' tags: - scan_log '/v1/scans/vulns/{vuln_id}/ticket': parameters: - name: vuln_id in: path required: true schema: type: string post: operationId: post-vulns-id-ticket summary: Create vulns export to tracker description: Create vulns export to tracker parameters: - name: reporting_config_id in: query schema: type: string - name: X-Team-Id in: header description: 'Retrieve the Team ID from: https://cloud.projectdiscovery.io/settings/team' schema: type: string responses: '200': $ref: '#/components/responses/VulnsTrackerExportResponse' '400': $ref: '#/components/responses/ErrorResponse' '401': $ref: '#/components/responses/ErrorResponse' '424': $ref: '#/components/responses/ErrorResponse' '500': $ref: '#/components/responses/ErrorResponse' default: $ref: '#/components/responses/ErrorResponse' security: - X-API-Key: [] tags: - scans delete: operationId: delete-vulns-id-ticket summary: Delete vulns tracker association description: Delete vulns export tracker parameters: - name: provider_name in: query schema: type: string - name: X-Team-Id in: header description: 'Retrieve the Team ID from: https://cloud.projectdiscovery.io/settings/team' schema: type: string responses: '200': description: OK content: application/json: schema: type: object properties: ok: type: boolean '400': $ref: '#/components/responses/ErrorResponse' '401': $ref: '#/components/responses/ErrorResponse' '424': $ref: '#/components/responses/ErrorResponse' '500': $ref: '#/components/responses/ErrorResponse' default: $ref: '#/components/responses/ErrorResponse' security: - X-API-Key: [] tags: - Scans /v1/scans/config/exclude: get: operationId: get-scans-config-exclude summary: Get excluded templates description: Get excluded templates parameters: - name: X-Team-Id in: header description: 'Retrieve the Team ID from: https://cloud.projectdiscovery.io/settings/team' schema: type: string responses: '200': $ref: '#/components/responses/ExcludedTemplateResponse' '400': $ref: '#/components/responses/ErrorResponse' '401': $ref: '#/components/responses/ErrorResponse' '500': $ref: '#/components/responses/ErrorResponse' default: $ref: '#/components/responses/ErrorResponse' security: - X-API-Key: [] tags: - configurations post: operationId: post-scans-config-exclude summary: Add excluded templates description: Add excluded templates parameters: - name: X-Team-Id in: header description: 'Retrieve the Team ID from: https://cloud.projectdiscovery.io/settings/team' schema: type: string requestBody: $ref: '#/components/requestBodies/ExcludeConfigRequest' responses: '200': $ref: '#/components/responses/MessageResponse' '400': $ref: '#/components/responses/ErrorResponse' '401': $ref: '#/components/responses/ErrorResponse' '500': $ref: '#/components/responses/ErrorResponse' default: $ref: '#/components/responses/ErrorResponse' security: - X-API-Key: [] tags: - configurations delete: operationId: delete-scans-config-exclude summary: Delete excluded template ids description: Delete excluded template ids parameters: - name: X-Team-Id in: header description: 'Retrieve the Team ID from: https://cloud.projectdiscovery.io/settings/team' schema: type: string requestBody: $ref: '#/components/requestBodies/DeleteExcludedConfigRequest' responses: '200': $ref: '#/components/responses/MessageResponse' '400': $ref: '#/components/responses/ErrorResponse' '401': $ref: '#/components/responses/ErrorResponse' '500': $ref: '#/components/responses/ErrorResponse' default: $ref: '#/components/responses/ErrorResponse' security: - X-API-Key: [] tags: - configurations parameters: [] /v1/scans/token: get: operationId: get-v1-scans-token summary: Get Scans Token description: Get user scan token usage details parameters: - name: X-Team-Id in: header description: 'Retrieve the Team ID from: https://cloud.projectdiscovery.io/settings/team' schema: type: string responses: '200': $ref: '#/components/responses/GetScansTokenResponse' '400': $ref: '#/components/responses/MessageResponse' '401': $ref: '#/components/responses/MessageResponse' '404': $ref: '#/components/responses/GetScanTokenErrorResponse' '500': $ref: '#/components/responses/MessageResponse' tags: - scans '/v1/asset/{asset_id}': parameters: - name: asset_id in: path required: true schema: type: integer format: int64 get: operationId: get-v1-asset-id summary: Get enumerated asset details parameters: - name: X-Team-Id in: header description: 'Retrieve the Team ID from: https://cloud.projectdiscovery.io/settings/team' schema: type: string responses: '200': $ref: '#/components/responses/GetAssetResponse' '400': $ref: '#/components/responses/ErrorResponse' '401': $ref: '#/components/responses/ErrorResponse' '404': $ref: '#/components/responses/ErrorResponse' '500': $ref: '#/components/responses/ErrorResponse' default: $ref: '#/components/responses/ErrorResponse' tags: - assets delete: operationId: delete-v1-asset-asset_id summary: Delete enumerated asset parameters: - name: X-Team-Id in: header description: 'Retrieve the Team ID from: https://cloud.projectdiscovery.io/settings/team' schema: type: string responses: '200': $ref: '#/components/responses/MessageResponse' '400': $ref: '#/components/responses/ErrorResponse' '401': $ref: '#/components/responses/ErrorResponse' '500': $ref: '#/components/responses/ErrorResponse' default: $ref: '#/components/responses/ErrorResponse' tags: - assets patch: operationId: patch-v1-asset-asset_id summary: Update asset details parameters: - name: X-Team-Id in: header description: 'Retrieve the Team ID from: https://cloud.projectdiscovery.io/settings/team' schema: type: string requestBody: $ref: '#/components/requestBodies/UpdateEnumeratedAssetRequest' responses: '200': $ref: '#/components/responses/MessageResponse' '400': $ref: '#/components/responses/ErrorResponse' '401': $ref: '#/components/responses/ErrorResponse' '500': $ref: '#/components/responses/ErrorResponse' default: $ref: '#/components/responses/ErrorResponse' tags: - assets '/v1/asset/enumerate/{enumerate_id}/stats': parameters: - name: enumerate_id in: path required: true schema: type: string - name: time in: query description: time filter to select schema: default: all_time $ref: '#/components/schemas/TimeRangeQueryParameter' - name: start_date in: query description: time filter start date schema: type: string format: date - name: end_date in: query description: time filter end date schema: type: string format: date get: operationId: get-v1-asset-enumerate-enumerate_id-stats summary: Get enumeration stats parameters: - name: X-Team-Id in: header description: 'Retrieve the Team ID from: https://cloud.projectdiscovery.io/settings/team' schema: type: string responses: '200': $ref: '#/components/responses/EnumerationStatsResponse' '400': $ref: '#/components/responses/ErrorResponse' '401': $ref: '#/components/responses/ErrorResponse' '500': $ref: '#/components/responses/ErrorResponse' default: $ref: '#/components/responses/ErrorResponse' tags: - enumerations /v1/asset/enumerate/stats: parameters: - name: time in: query description: time filter to select schema: default: all_time $ref: '#/components/schemas/TimeRangeQueryParameter' - name: start_date in: query description: time filter start date schema: type: string format: date - name: end_date in: query description: time filter end date schema: type: string format: date get: operationId: get-v1-asset-enumerate-stats summary: Get all enumeration stats parameters: - name: X-Team-Id in: header description: 'Retrieve the Team ID from: https://cloud.projectdiscovery.io/settings/team' schema: type: string responses: '200': $ref: '#/components/responses/EnumerationStatsResponse' '400': $ref: '#/components/responses/ErrorResponse' '401': $ref: '#/components/responses/ErrorResponse' '500': $ref: '#/components/responses/ErrorResponse' default: $ref: '#/components/responses/ErrorResponse' tags: - enumerations '/v1/asset/enumerate/{enumerate_id}/config': parameters: - name: enumerate_id in: path required: true schema: type: string get: operationId: get-v1-asset-enumerate-enumerate_id-config summary: Get enumeration config parameters: - name: X-Team-Id in: header description: 'Retrieve the Team ID from: https://cloud.projectdiscovery.io/settings/team' schema: type: string responses: '200': description: Shared Response content: application/json: schema: $ref: '#/components/schemas/EnumerationConfig' '400': $ref: '#/components/responses/ErrorResponse' '401': $ref: '#/components/responses/ErrorResponse' '500': $ref: '#/components/responses/ErrorResponse' default: $ref: '#/components/responses/ErrorResponse' tags: - enumerations patch: operationId: patch-v1-asset-enumerate-enumerate_id-config summary: Update enumeration config parameters: - name: update_type in: query description: default mode is append schema: type: string enum: - append - replace - name: X-Team-Id in: header description: 'Retrieve the Team ID from: https://cloud.projectdiscovery.io/settings/team' schema: type: string requestBody: description: Shared Request content: application/json: schema: $ref: '#/components/schemas/EnumerationConfig' responses: '200': $ref: '#/components/responses/MessageResponse' '400': $ref: '#/components/responses/ErrorResponse' '401': $ref: '#/components/responses/ErrorResponse' '500': $ref: '#/components/responses/ErrorResponse' default: $ref: '#/components/responses/ErrorResponse' tags: [] '/v1/asset/screenshot/{asset_id}': parameters: - name: asset_id in: path required: true schema: type: string get: operationId: get-v1-asset-screenshot-asset_id summary: Get Asset Screenshot parameters: - name: X-Team-Id in: header description: 'Retrieve the Team ID from: https://cloud.projectdiscovery.io/settings/team' schema: type: string responses: '200': description: OK content: image/png: schema: type: string '400': $ref: '#/components/responses/ErrorResponse' '401': $ref: '#/components/responses/ErrorResponse' '500': $ref: '#/components/responses/ErrorResponse' tags: - assets /v1/user/usage: get: operationId: get-v1-user-usage summary: Get API Services Usage parameters: - name: X-Team-Id in: header description: 'Retrieve the Team ID from: https://cloud.projectdiscovery.io/settings/team' schema: type: string requestBody: $ref: '#/components/requestBodies/UsageRequest' responses: '200': $ref: '#/components/responses/UsageResponse' '400': $ref: '#/components/responses/MessageResponse' '401': $ref: '#/components/responses/MessageResponse' '500': $ref: '#/components/responses/MessageResponse' security: - X-API-Key: [] tags: - usage parameters: [] /v1/asset/enumerate/filters: get: operationId: get-v1-asset-enumerate-filters summary: Group assets by filters parameters: - name: offset in: query description: The number of items to skip before starting to collect the result set schema: type: integer - name: limit in: query description: The numbers of items to return schema: type: integer - name: host in: query schema: type: string - name: port in: query schema: type: string - name: ip in: query schema: type: string - name: cname in: query schema: type: string - name: technologies in: query schema: type: string - name: status_code in: query schema: type: string - name: content_length in: query schema: type: string - name: domain in: query schema: type: array items: type: string - name: title in: query schema: type: string - name: webserver in: query schema: type: string - name: favicon in: query schema: type: string - name: group_by in: query description: 'Group by type. e.g. - host, port, favicon.' required: true schema: $ref: '#/components/schemas/EnumerateFilterTypes' - name: sort_asc in: query description: 'supported sort fields [count]' schema: type: string - name: sort_desc in: query description: 'supported sort fields [count]' schema: type: string - name: time in: query description: time filter to select schema: default: all_time $ref: '#/components/schemas/TimeRangeQueryParameter' - name: start_date in: query description: time filter start date schema: type: string format: date - name: end_date in: query description: time filter end date schema: type: string format: date - name: X-Team-Id in: header description: 'Retrieve the Team ID from: https://cloud.projectdiscovery.io/settings/team' schema: type: string responses: '200': $ref: '#/components/responses/GetEnumerateFiltersResponse' '400': $ref: '#/components/responses/ErrorResponse' '401': $ref: '#/components/responses/ErrorResponse' '500': $ref: '#/components/responses/ErrorResponse' default: $ref: '#/components/responses/ErrorResponse' tags: - enumerations '/v1/asset/enumerate/{enumerate_id}/filters': parameters: - name: enumerate_id in: path required: true schema: type: string get: operationId: get-v1-asset-enumerate-id-filters summary: Group assets by filters for an enumeration parameters: - name: offset in: query description: The number of items to skip before starting to collect the result set schema: type: integer - name: limit in: query description: The numbers of items to return schema: type: integer - name: host in: query schema: type: string - name: port in: query schema: type: string - name: ip in: query schema: type: string - name: cname in: query schema: type: string - name: technologies in: query schema: type: string - name: status_code in: query schema: type: string - name: content_length in: query schema: type: string - name: domain in: query schema: type: array items: type: string - name: title in: query schema: type: string - name: webserver in: query schema: type: string - name: favicon in: query schema: type: string - name: group_by in: query description: 'Group by type. e.g. - host, port, favicon.' required: true schema: $ref: '#/components/schemas/EnumerateFilterTypes' - name: sort_asc in: query description: 'supported sort fields [count]' schema: type: string - name: sort_desc in: query description: 'supported sort fields [count]' schema: type: string - name: time in: query description: time filter to select schema: default: all_time $ref: '#/components/schemas/TimeRangeQueryParameter' - name: start_date in: query description: time filter start date schema: type: string format: date - name: end_date in: query description: time filter end date schema: type: string format: date - name: X-Team-Id in: header description: 'Retrieve the Team ID from: https://cloud.projectdiscovery.io/settings/team' schema: type: string responses: '200': $ref: '#/components/responses/GetEnumerateFiltersResponse' '400': $ref: '#/components/responses/ErrorResponse' '401': $ref: '#/components/responses/ErrorResponse' '500': $ref: '#/components/responses/ErrorResponse' default: $ref: '#/components/responses/ErrorResponse' tags: - enumerations /v1/asset/enumerate/export: parameters: - name: async in: query schema: type: boolean get: operationId: get-enumerate-export summary: Export Enumeration of user description: Export enumeration content parameters: - name: format in: query schema: $ref: '#/components/schemas/EnumExportFormats' - name: search in: query description: Search on the content name schema: type: string - name: labels in: query description: 'Filter by comma separated labels, e.g-> labels=p1,p2' schema: type: string - name: is_new in: query description: Filter by new content schema: type: boolean - name: host in: query description: 'Filter by comma separated labels, e.g-> host=p1,p2' schema: type: string - name: port in: query description: 'Filter by port separated labels, e.g-> port=p1,p2' schema: type: string - name: status_code in: query description: 'Filter by status code separated labels, e.g-> status_code=p1,p2' schema: type: string - name: title in: query description: 'Filter by title separated labels, e.g-> title=p1,p2' schema: type: string - name: content_length in: query description: 'Filter by content length separated labels, e.g-> content_length=p1,p2' schema: type: string - name: domain in: query description: 'Filter by domain names separated labels, e.g-> domain=domain1.com,domain2.com' schema: type: string - name: cname in: query description: cname to filter schema: type: string - name: technologies in: query description: technologies to filter schema: type: string - name: sort_asc in: query description: 'comma separated ascending sorting e.g sort_asc=created_at,name' schema: type: string - name: sort_desc in: query schema: type: string - name: time in: query description: time filter to select schema: default: all_time $ref: '#/components/schemas/TimeRangeQueryParameter' - name: start_date in: query description: time filter start date schema: type: string format: date - name: end_date in: query description: time filter end date schema: type: string format: date - name: X-Team-Id in: header description: 'Retrieve the Team ID from: https://cloud.projectdiscovery.io/settings/team' schema: type: string responses: '200': description: OK content: application/octet-stream: schema: type: string '201': description: Created content: application/json: schema: type: object properties: export_id: type: string required: - export_id '400': $ref: '#/components/responses/ErrorResponse' '401': $ref: '#/components/responses/ErrorResponse' '500': $ref: '#/components/responses/ErrorResponse' default: $ref: '#/components/responses/ErrorResponse' security: - X-API-Key: [] tags: - enumerations /v1/user/tunnels: get: operationId: get-v1-user-tunnels summary: Get Tunnels List responses: '200': $ref: '#/components/responses/GetUserTunnelResponse' '400': $ref: '#/components/responses/MessageResponse' '401': $ref: '#/components/responses/MessageResponse' '404': $ref: '#/components/responses/MessageResponse' '500': $ref: '#/components/responses/MessageResponse' default: $ref: '#/components/responses/MessageResponse' security: - X-API-Key: [] tags: - users parameters: [] /v1/asset/exposures/metrics: get: operationId: get-v1-asset-exposures-metrics summary: Get exposure metrics parameters: - name: interval in: query description: The time interval for the metrics required: false schema: type: string default: monthly enum: - monthly responses: '200': $ref: '#/components/responses/ExposureMetricsResponse' '400': $ref: '#/components/responses/MessageResponse' '401': $ref: '#/components/responses/MessageResponse' '404': $ref: '#/components/responses/MessageResponse' '500': $ref: '#/components/responses/MessageResponse' default: $ref: '#/components/responses/MessageResponse' security: - X-API-Key: [] tags: - asset components: parameters: template_id: name: template_id in: query schema: type: string description: short uuid of requested template required: true user_name: name: user_name in: query required: true schema: type: string description: user name of logged in user schemas: EnumExportFormats: type: string enum: - raw - json - csv title: EnumExportFormats TimeRangeQueryParameter: type: string enum: - last_day - last_week - last_month - last_3_months - last_6_months - last_12_months - all_time title: TimeRangeQueryParameter EnumerateFilterTypes: type: string enum: - host - port - ip - cname - technologies - status_code - content_length - title - webserver - favicon - domain title: EnumerateFilterTypes EnumerateFiltersItem: type: object properties: value: type: string port: type: integer technologies: type: integer categories: type: array items: type: string description: type: string website: type: string cpe: type: string icon: type: string favicon_body: type: string count: type: integer required: - value - count title: EnumerateFiltersItem VulnerabilityResults: type: object properties: matcher_status: type: boolean vuln_id: type: string target: type: string template_url: type: string created_at: type: string updated_at: type: string scan_id: type: string event: type: array items: $ref: '#/components/schemas/VulnerabilityEvent' template_id: type: string template_path: type: string template_encoded: type: string result_type: type: string vuln_status: type: string vuln_hash: type: string labels: type: array items: type: string required: - matcher_status - vuln_id - target - created_at - scan_id - event - template_id - result_type - vuln_hash PrivateTemplates: type: object properties: name: type: string contents: type: string required: - name - contents title: PrivateTemplates AssetListItem: type: object properties: asset_count: type: integer asset_id: type: string uploaded_at: type: string name: type: string required: - asset_count - asset_id - uploaded_at - name title: AssetListItem ScanSchedule: type: object properties: scan_frequency: type: string scan_id: type: string schedule_last_run: type: string schedule_next_run: type: string start_time: type: string format: time hourly_frequency: type: integer custom_weekdays: description: |- Array of integer denoting the weekdays on which the scan is supposed to run. 0-6 denoting Sunday-Saturday. type: array items: type: integer minimum: 0 maximum: 6 required: - scan_frequency - scan_id - schedule_last_run - schedule_next_run title: ScanSchedule ScanStatusItem: type: object properties: scan_id: type: string status: type: string scan_time_elapsed: type: string progress: type: integer failure_reason: type: string created_at: type: string updated_at: type: string total_target: type: integer completed_at: type: string total_scan: type: integer total_template: type: integer name: type: string severity: type: object is_oss: type: boolean is_cloud: type: boolean asset_ids: type: array items: type: string is_rescan: type: boolean public_templates: type: array items: type: string report_config_ids: type: array items: type: string rescan_count: type: integer scan_config_ids: type: array items: type: string template_ids: type: array items: type: string template_urls: type: array items: type: string schedule: $ref: '#/components/schemas/ScanSchedule' total_result: type: integer required: - scan_id - status - scan_time_elapsed - progress - failure_reason - created_at - updated_at - total_target - completed_at - total_scan - total_template - name - is_oss - is_cloud - total_result title: ScanStatusItem JiraVerifyContentItemIssueType: type: object properties: id: type: string name: type: string statuses: type: array items: type: string required: - id - name title: JiraVerifyContentItemIssueType JiraVerifyContentItem: type: object properties: project_id: type: string project_name: type: string issue_types: type: array items: type: object $ref: '#/components/schemas/JiraVerifyContentItemIssueType' required: - project_id - project_name - issue_types title: JiraVerifyContentItem VulnerabilityEvent: type: object properties: curl-command: type: string extracted-results: type: array items: type: string extractor-name: type: string host: type: string info: type: object properties: classification: type: object properties: cpe: type: string cve-id: type: array items: type: string cvss-metrics: type: string cvss-score: type: number cwe-id: type: array items: type: string epss-percentile: type: number epss-score: type: number metadata: type: object author: type: array items: type: string description: type: string impact: type: string name: type: string tags: type: array items: type: string reference: type: array items: type: string remediation: type: string severity: type: string required: - name ip: type: string matched-at: type: string matched-line: type: array items: type: integer matcher-name: type: string matcher-status: type: boolean path: type: string request: type: string response: type: string template-id: type: string template-path: type: string timestamp: type: string type: type: string issue_trackers: type: object properties: jira: $ref: '#/components/schemas/VulnIssueTrackerItem' github: $ref: '#/components/schemas/VulnIssueTrackerItem' gitlab: $ref: '#/components/schemas/VulnIssueTrackerItem' linear: $ref: '#/components/schemas/VulnIssueTrackerItem' title: VulnerabilityEvent FiltersItem: type: object properties: value: type: string name: type: string severity: type: string count: type: integer required: - value - count title: FilterItem UserWorkspaces: type: object properties: name: type: string team_id: type: string active: type: boolean plan: type: string member_count: type: integer required: - name - team_id - active - plan - member_count title: UserWorkspaces ScanStats: type: object properties: cves: type: integer matched: type: integer not_matched: type: integer severity: type: object total_count: type: integer total_scan: type: integer total_target: type: integer total_template: type: integer vuln_status: type: object required: - cves - matched - not_matched - total_count - total_scan - total_target - total_template title: ScanStats VulnerabilityResultsOld: type: object properties: scan_id: type: string target: type: string template_encoded: type: string template_url: type: string template_path: type: string template_id: type: string vuln_id: type: string matcher_status: type: boolean created_at: type: string updated_at: type: string event: $ref: '#/components/schemas/VulnerabilityEvent' id: type: string vuln_status: type: string vuln_hash: type: string required: - scan_id - target - template_id - vuln_id - matcher_status - created_at - event title: VulnerabilityResultsOld templateListItem: type: object properties: created_at: type: string id: type: string name: type: string shared_publicly: type: boolean updated_at: type: string required: - created_at - id - name title: templateListItem ExportListItem: description: Export List Item type: object properties: id: type: string name: type: string export_status: type: string item_type: type: string download_signed_url: type: string created_at: type: string format: date-time required: - id - name - export_status - item_type - created_at title: ExportListItem UserAuditLogItems: type: object properties: created_at: type: string email: type: string action: type: string status: type: integer method: type: string ip: type: string required: - created_at - email - action - status - method - ip title: UserAuditLogItems PublicTemplateListItem: type: object properties: id: type: string templateURL: type: string name: type: string required: - id - templateURL - name title: PublicTemplateListItem EarlyTemplateListItem: type: object properties: id: type: string templateURL: type: string name: type: string required: - id - templateURL - name title: EarlyTemplateListItem TeamMemberItem: type: object properties: email: type: string status: type: string role: type: string invited_at: type: string accepted_at: type: string profile_image: type: string required: - email - status - role title: TeamMemberItem WorkspaceItem: type: object properties: id: type: string name: type: string created_at: type: string member_count: type: integer owner_email: type: string required: - id - name - created_at - member_count - owner_email title: TeamMemberItem ScanUsageStatsResponse: description: 'Scan Usage Stats ' type: object properties: time: type: string format: date-time scan_id: type: string user_id: type: integer format: int64 completed_request: type: integer format: int64 total_target: type: integer format: int64 total_templates: type: integer format: int64 total_result: type: integer format: int64 severity_breakdown: type: string format: json required: - time - scan_id - user_id - completed_request - total_target - total_templates - total_result - severity_breakdown title: ScanUsageStatsResponse VulnStatusEnum: enum: - open - false_positive - fixed - duplicate - fix_in_progress - accepted_risk title: VulnStatusEnum ConfigResponse: type: object properties: id: type: string config: type: string config_type: $ref: '#/components/schemas/ConfigTypeEnum' name: type: string read_only: type: boolean global: type: boolean provider_name: type: string created_at: type: string format: date-time updated_at: type: string format: date-time required: - id - config - config_type - name - created_at - updated_at title: ConfigResponse ConfigTypeEnum: type: string enum: - scan - reporting - template - alerting - cloudlist title: ConfigTypeEnum EnumerationStats: type: object properties: hosts: type: integer format: int64 http: type: integer format: int64 endpoints: type: integer format: int64 ports: type: integer format: int64 total_assets: type: integer format: int64 required: - hosts - http - endpoints - ports - total_assets title: EnumerationStats EnumerateData: type: object properties: id: type: string name: type: string status: type: string failure_reason: type: string completed_at: type: string format: date-time enumeration_time: type: string format: duration enumeration_type: type: string enumeration_stats: $ref: '#/components/schemas/EnumerationStats' created_at: type: string format: date-time updated_at: type: string format: date-time root_domains: type: array items: type: string enrichment_hosts_count: type: integer is_rescan: type: boolean rescan_count: type: integer cloudlist_config_ids: type: array items: type: string cloudlist_provider_name: type: string enumeration_time_elapsed: type: string total_assets: type: integer format: int64 new_assets: type: integer format: int64 domain_names: type: array items: type: string schedule: $ref: '#/components/schemas/EnumerationSchedule' required: - id - name - status - created_at title: EnumerateData EnumerationContent: type: object properties: enumeration_id: type: string name: type: string created_at: type: string updated_at: type: string id: type: integer format: int64 labels: type: array items: type: string cname: type: array items: type: string host: type: string port: type: integer ip: type: array items: type: string status_code: type: integer content_length: type: integer title: type: string technologies: type: array items: type: string webserver: type: string method: type: string source: type: string is_new: type: boolean type: type: string asset_hash: type: string technology_details: type: object additionalProperties: $ref: '#/components/schemas/EnumerationContentTechnologyDetails' screenshot_path: type: string favicon: type: string favicon_body: type: string cdn_name: type: string chain_status_codes: type: array items: type: string domain_name: type: string redirect_location: type: string required: - enumeration_id - name - created_at - id - is_new title: EnumerationContent EnumerationContentTechnologyDetails: type: object properties: description: type: string website: type: string icon: type: string categories: type: array items: type: string title: EnumerationContentTechnologyDetails EnumerationIds: type: object properties: id: type: string type: type: array items: type: string required: - id - type title: EnumerationIds EnumerationSchedule: type: object properties: enumeration_id: type: string scan_frequency: type: string schedule_last_run: type: string schedule_next_run: type: string start_time: type: string format: time hourly_frequency: type: integer custom_weekdays: description: |- Array of integer denoting the weekdays on which the scan is supposed to run. 0-6 denoting Sunday-Saturday. type: array items: type: integer minimum: 0 maximum: 6 required: - enumeration_id - scan_frequency - schedule_last_run - schedule_next_run title: EnumerationSchedule ScansHistoryItems: type: object properties: completed_request: type: integer name: type: string scan_id: type: string scan_time: type: string severity: type: object status: type: string time: type: string total_request: type: integer total_result: type: integer total_target: type: integer total_templates: type: integer title: ScansHistoryItems GithubTemplateListItem: type: object properties: id: type: string templateURL: type: string name: type: string required: - id - templateURL - name title: GithubTemplateListItem IntegrationListItems: type: object properties: connection_id: type: string integration_id: type: string status: type: string identifier: type: string org_name: type: string account_type: type: string handle: type: string required: - connection_id - integration_id - status - identifier - org_name - account_type - handle title: GithubTemplateListItem TemplateStats: type: object properties: date: type: string statistics: type: object properties: authors: type: object classification: type: object properties: total: type: integer cvss-metrics: type: integer cvss-score: type: integer cve-id: type: integer cwe-id: type: integer description: type: integer directory: type: object properties: total: type: integer name: type: integer references: type: integer remediation: type: integer severity: type: object properties: total: type: integer critical: type: integer high: type: integer medium: type: integer low: type: integer info: type: integer unknown: type: integer tags: type: object total: type: integer type: type: object properties: total: type: integer http: type: integer dns: type: integer network: type: integer file: type: integer ssl: type: integer websocket: type: integer workflow: type: integer headless: type: integer template-version: type: string x-examples: Example 1: date: '2024-02-03T08:40:19.911720715Z' statistics: authors: 0h1in9e: 1 0ri2n: 13 0ut0fb4nd: 1 0w4ys: 3 classification: total: 4772 cvss-metrics: 4650 cvss-score: 2999 cve-id: 2349 cwe-id: 4679 description: 6665 directory: total: 0 name: 7810 references: 5369 remediation: 2231 severity: total: 7810 critical: 947 high: 1563 medium: 1457 low: 257 info: 3551 unknown: 35 tags: '360': 1 '3600': 1 '''rpcms''': 1 total: 7810 type: total: 7810 http: 7005 dns: 21 network: 134 file: 312 ssl: 27 websocket: 0 workflow: 191 headless: 16 template-version: main TemplateLeaderboard: type: object properties: data: type: array items: type: object properties: author: type: string category: type: object properties: cloud: type: integer cve: type: integer fuzz: type: integer kve: type: integer links: type: object properties: email: type: string github: type: string linkedin: type: string twitter: type: string website: type: string points: type: integer protocol: type: object properties: dns: type: integer file: type: integer headless: type: integer http: type: integer ssl: type: integer tcp: type: integer rank: type: integer severity: type: object properties: critical: type: integer high: type: integer info: type: integer low: type: integer medium: type: integer unknown: type: integer templates: type: integer date: type: string result: type: integer total: type: integer x-examples: Example 1: data: - author: dhiyaneshdk category: cloud: 0 cve: 154 fuzz: 1 kve: 34 links: email: '' github: '' linkedin: '' twitter: '' website: '' points: 26065 protocol: dns: 0 file: 85 headless: 1 http: 1044 ssl: 0 tcp: 1 rank: 1 severity: critical: 90 high: 195 info: 592 low: 89 medium: 161 unknown: 12 templates: 1139 - author: naglis category: cloud: 0 cve: 0 fuzz: 0 kve: 0 links: email: '' github: '' linkedin: '' twitter: '' website: '' points: 10 protocol: dns: 0 file: 1 headless: 0 http: 0 ssl: 0 tcp: 0 rank: 792 severity: critical: 0 high: 0 info: 1 low: 0 medium: 0 unknown: 0 templates: 1 date: all_time result: 794 total: 794 EnumerationIDTypes: type: object properties: id: type: string required: - id title: EnumerationIDTypes EnumerationIDTypesDetail: type: object properties: id: type: string name: type: string total_assets: type: integer enumeration_type: type: string cloudlist_provider_name: type: string types: type: array items: enum: - hosts - ports - http - endpoints required: - id - types - name - enumeration_type title: EnumerationIDTypesDetail ScanConfigItem: type: object properties: id: type: string name: type: string provider_name: type: string config_type: type: string required: - id - name - config_type title: ScanConfigItem ScanConfig: type: object properties: targets: type: array items: type: string assets_lists: type: array items: type: string public_templates: type: array items: type: string early_templates: type: array items: type: string template_urls: type: array items: type: string template_ids: type: array items: type: string scan_config_ids: type: array items: $ref: '#/components/schemas/ScanConfigItem' report_config_ids: type: array items: $ref: '#/components/schemas/ScanConfigItem' alerting_config_ids: type: array items: $ref: '#/components/schemas/ScanConfigItem' enumeration_ids: type: array items: $ref: '#/components/schemas/EnumerationIDTypesDetail' title: ScanConfig ScanConfigUpdateItem: type: object properties: targets: type: array items: type: string assets_lists: type: array items: type: string templates: type: array items: type: string early_templates: type: array items: type: string scan_config_ids: type: array items: type: string report_config_ids: type: array items: type: string alerting_config_ids: type: array items: type: string enumeration_ids: type: array items: $ref: '#/components/schemas/EnumerationIDTypes' title: ScanConfigUpdateItem ScanLogResp: type: object properties: target: type: string template_id: type: string matched: type: boolean error: type: string timestamp: type: string severity: type: string event: type: string vuln_hash: type: string required: - target - template_id - matched - timestamp title: ScanLogResp SchedulerFrequency: description: Allowed frequencies for the scheduler type: string enum: - hourly - daily - weekly - monthly - custom title: SchedulerFrequency ExcludedTemplate: type: object properties: id: type: integer format: int64 value: type: string created_at: type: string format: date-time updated_at: type: string format: date-time required: - id - value - created_at - updated_at title: ExcludedTemplate EnumerationCounts: description: Example response type: object properties: total_enumeration: type: integer format: int64 total_unique_enumeration: type: integer format: int64 total_uploaded_enumeration: type: integer format: int64 total_discovery_enumeration: type: integer format: int64 total_cloud_enumeration: type: integer format: int64 title: EnumerationCounts AssetStats: type: object properties: hosts: type: integer format: int64 http: type: integer format: int64 endpoints: type: integer format: int64 ports: type: integer format: int64 new_assets: type: integer format: int64 total_assets: type: integer format: int64 technologies: type: integer format: int64 required: - hosts - http - endpoints - ports - total_assets - new_assets - technologies title: AssetStats PriceListItem: type: object properties: price_id: type: string amount: type: integer monthly_token: type: integer recurrence: type: string required: - price_id - amount - recurrence - monthly_token title: PriceListItem VulnIssueTrackerItem: type: object properties: id: type: string url: type: string title: VulnIssueTrackerItem EnumerationConfig: type: object properties: name: type: string root_domains: type: array items: type: string enrichment_inputs: type: array items: type: string steps: type: array items: type: string enum: - dns_resolve - dns_bruteforce - dns_permute - port_scan - http_probe - http_screenshot - dns_passive enum_ports: type: string enumeration_config: $ref: '#/components/schemas/EnumerationLaunchConfig' title: EnumerationConfig EnumerationLaunchConfig: type: object properties: follow-redirect: type: boolean ports: type: string title: EnumerationLaunchConfig TunnelItem: type: object properties: name: type: string os: type: string arch: type: string tunnel_ip: type: string tunnel_port: type: string client_ip: type: string username: type: string token: type: string required: - name - os - arch - tunnel_ip - tunnel_port - client_ip - username - token title: TunnelItem ServiceUsageItem: type: object properties: used: type: integer remaining: type: integer total: type: integer required: - used - remaining - total title: ServiceUsageLimitItem UsageRangeEnum: type: string enum: - daily - weekly - monthly - custom title: UsageRangeEnum ExposuresTimeSeries: type: object properties: date: type: string format: date assets: type: integer technologies: type: integer title: ExposuresTimeSeries requestBodies: UpdateTemplateRequest: content: application/json: schema: type: object properties: template: type: string template_id: type: string prompt: type: string required: - template - template_id CreateTemplateRequest: content: application/json: schema: type: object properties: template: type: string GenerateTemplateRequest: content: application/json: schema: type: object properties: prompt: type: string required: - prompt RetestTemplateRequest: content: application/json: schema: type: object properties: template_encoded: type: string target: type: string template_path: type: string template_url: type: string template_id: type: string vuln_id: type: string ShareTemplateRequest: content: application/json: schema: type: object properties: template_id: type: string is_public: type: boolean required: - template_id - is_public TriggerUserScanRequest: content: application/json: schema: type: object properties: targets: type: array items: type: string templates: type: array items: type: string assets: type: array items: type: string private_templates: type: array items: $ref: '#/components/schemas/PrivateTemplates' name: type: string recommended: type: boolean all: type: boolean alerting_config_ids: type: array items: type: string scan_config_ids: type: array items: type: string reporting_config_ids: type: array items: type: string early_templates: type: array items: type: string exclude_targets: type: array items: type: string enumeration_ids: type: array items: $ref: '#/components/schemas/EnumerationIds' schedule_only: type: boolean disable_global_alert_config: type: boolean disable_global_report_config: type: boolean disable_global_scan_config: type: boolean socks5_proxy: type: string SetScanScheduleRequest: content: application/json: schema: type: object properties: scan_id: type: string scan_frequency: $ref: '#/components/schemas/SchedulerFrequency' start_time: type: string format: time hourly_frequency: type: integer maximum: 24 minimum: 1 custom_weekdays: description: |- 0-6 denoting Sunday-Saturday. It accepts an array of weekday type: array items: type: integer minimum: 0 maximum: 6 required: - scan_id - scan_frequency SetEnumerationScheduleRequest: content: application/json: schema: type: object properties: enumeration_id: type: string scan_frequency: $ref: '#/components/schemas/SchedulerFrequency' start_time: type: string format: time hourly_frequency: type: integer maximum: 24 minimum: 1 custom_weekdays: description: |- 0-6 denoting Sunday-Saturday. It accepts an array of weekday type: array items: type: integer minimum: 0 maximum: 6 required: - enumeration_id - scan_frequency UpdateAssetRequest: content: application/json: schema: type: object properties: name: type: string required: - name UpdateScanRequest: content: application/json: schema: type: object properties: name: type: string required: - name PostFeedbackRequest: content: application/json: schema: type: object properties: feedback_text: type: string required: - feedback_text PatchUserProfile: content: application/json: schema: type: object properties: email: type: string ai_status: type: boolean scan_status: type: boolean static_scan: type: boolean early_template: type: boolean max_team: type: integer read_only: type: boolean audit_log: type: boolean required: - email CreateTeamRequest: content: application/json: schema: type: object properties: name: type: string required: - name AddTeamMemberRequest: content: application/json: schema: type: object properties: email: type: string required: - email DeleteTeamMemberRequest: content: application/json: schema: type: object properties: email: type: string required: - email InviteTeamMemberRequest: content: application/json: schema: type: object properties: invite_code: type: string required: - invite_code PatchTeamMemberRequest: content: application/json: schema: type: object properties: email: type: string role: type: string required: - email AdminAddTeamMemberRequest: content: application/json: schema: type: object properties: owner_email: type: string member_email: type: string required: - owner_email - member_email PatchScanVulnsRequest: content: application/json: schema: type: object properties: vuln_ids: type: array items: type: string vuln_status: $ref: '#/components/schemas/VulnStatusEnum' type: type: string scan_id: type: string severity: type: array items: type: string host: type: array items: type: string template: type: array items: type: string search: type: string required: - vuln_status PatchScanVulnsLabelsRequest: content: application/json: schema: type: object properties: ids: type: array items: type: string type: type: string labels: type: array items: type: string required: - ids VerifyConfigRequest: content: application/json: schema: type: object properties: config: type: string config_type: type: string required: - config VerifyConfigContentsRequest: content: application/json: schema: type: object properties: config: type: string config_type: type: string required: - config DeleteVulnsRequest: content: application/json: schema: type: object properties: ids: type: array items: type: string type: type: string vuln_status: type: array items: type: string scan_id: type: string severity: type: array items: type: string host: type: array items: type: string template: type: array items: type: string search: type: string CreateContributeRequest: content: application/json: schema: type: object properties: email: type: string name: type: string template: type: string anonymous: type: boolean required: - template - anonymous ExcludeConfigRequest: content: application/json: schema: type: object properties: values: type: array items: type: string required: - values DeleteExcludedConfigRequest: content: application/json: schema: type: object properties: ids: type: array items: type: integer format: int64 required: - ids UpdateEnumeratedAssetRequest: content: application/json: schema: type: object properties: labels: type: array items: type: string name: type: string PatchTeamAdmin: content: application/json: schema: type: object properties: max_members: type: integer required: - max_members UsageRequest: content: application/json: schema: type: object properties: range: $ref: '#/components/schemas/UsageRangeEnum' startDate: type: string endDate: type: string required: - range AdminSetUsageLimit: content: application/json: schema: type: object properties: email: type: string format: email chaos_allowed_requests: type: number cvemap_allowed_requests: type: number asnmap_allpwed_requests: type: number required: - email AdminUsageRequest: content: application/json: schema: type: object properties: email: type: string format: email range: $ref: '#/components/schemas/UsageRangeEnum' startDate: type: string endDate: type: string required: - email - range responses: GetTemplateResponse: description: Example response content: application/json: schema: type: object properties: prompt: type: string message: type: string template: type: string is_public: type: boolean required: - message application/xml: schema: type: object CreateTemplateResponse: description: Example response content: application/json: schema: type: object properties: message: type: string status: type: boolean template_id: type: string template_name: type: string required: - message - template_id - template_name UpdateTemplateResponse: description: Example response content: application/json: schema: type: object properties: message: type: string status: type: boolean template_id: type: string template_name: type: string required: - message - template_id - template_name GenerateTemplateResponse: description: Example response content: application/json: schema: type: object properties: template_id: type: string message: type: string completion: type: string name: type: string required: - message ShareTemplateResponse: description: Example response content: application/json: schema: type: object properties: message: type: string template_id: type: string status: type: boolean required: - message GetSharedTemplateResponse: description: Example response content: application/json: schema: type: object properties: template: type: string template_name: type: string message: type: string required: - message GetUserProfileResponse: description: Example response content: application/json: schema: type: object properties: ai_status: type: boolean email: type: string name: type: string message: type: string cloud_scans: type: boolean static_scan: type: boolean early_template: type: boolean team_name: type: string is_team_owner: type: boolean is_read_only: type: boolean team_owner_name: type: string trial_status: type: string role: type: string plan: type: string workspaces: type: array items: $ref: '#/components/schemas/UserWorkspaces' required: - message DeleteTemplateResponse: description: Example response content: application/json: schema: type: object properties: message: type: string status: type: boolean required: - message GetPublicTemplateList: description: Example response content: application/json: schema: type: object properties: version: type: string data: type: array items: $ref: '#/components/schemas/PublicTemplateListItem' required: - version - data GetRetestResultsResponse: description: Example response content: application/json: schema: type: object properties: message: type: string results: type: array items: $ref: '#/components/schemas/VulnerabilityResults' required: - message - results application/xml: schema: type: object GetSingleRetestResultResponse: description: Example response content: application/json: schema: type: object properties: message: type: string results: $ref: '#/components/schemas/VulnerabilityResults' required: - message - results GetScansStatusResponse: description: Example response content: application/json: schema: type: object properties: current_page: type: integer result_count: type: integer total_results: type: integer total_pages: type: integer message: type: string data: type: array items: $ref: '#/components/schemas/ScanStatusItem' required: - message - current_page - result_count - total_results - total_pages - data TriggerUserScanResponse: description: Example response content: application/json: schema: type: object properties: id: type: string message: type: string truncated-scan-targets: type: integer required: - message application/xml: schema: type: object properties: message: type: string id: type: string multipart/form-data: schema: type: object properties: message: type: string id: type: string required: - message text/html: schema: type: object properties: message: type: string id: type: string required: - message GetScanDetailsResponse: description: Example response content: application/json: schema: $ref: '#/components/schemas/ScanStatusItem' DeleteScansResponse: description: Example response content: application/json: schema: type: object properties: message: type: string ok: type: boolean required: - message GetScanResultsResponse: description: Example response content: application/json: schema: type: object properties: current_page: type: integer result_count: type: integer total_results: type: integer total_pages: type: integer message: type: string data: type: array items: $ref: '#/components/schemas/VulnerabilityResults' stats: type: object properties: total: type: integer filters: type: object required: - current_page - result_count - total_results - total_pages - message - data PostRetestTemplateResponse: description: Example response content: application/json: schema: type: object properties: message: type: string results: $ref: '#/components/schemas/VulnerabilityResults' required: - message GetScansVulnIdResponse: description: '/scans/vuln/:vuln_id' content: application/json: schema: $ref: '#/components/schemas/VulnerabilityResultsOld' ImportScanResponse: description: '' content: application/json: schema: description: Scan is a single scan object type: object properties: id: type: string message: type: string required: - id - message GetAssetsListResponse: description: Example response content: application/json: schema: type: object properties: message: type: string data: type: array items: $ref: '#/components/schemas/AssetListItem' required: - message - data UploadAssetResponse: description: Example response content: application/json: schema: type: object properties: message: type: string upload_status: type: string asset_id: type: string uploaded_at: type: string name: type: string required: - message GetUserAssetResponse: description: Example response content: application/json: schema: type: object properties: message: type: string asset_count: type: integer asset_id: type: string uploaded_at: type: string name: type: string required: - message DeleteAssetResponse: description: Example response content: application/json: schema: type: object properties: message: type: string required: - message GetUserAPIKeyResponse: description: Example response content: application/json: schema: type: object properties: message: type: string api_key: type: string required: - message - api_key DeleteUserAPIKeyResponse: description: Example response content: application/json: schema: type: object properties: message: type: string required: - message GetScanResultsFiltersResponse: description: Example response content: application/json: schema: type: object properties: message: type: string current_page: type: integer result_count: type: integer total_results: type: integer total_pages: type: integer data: type: array items: $ref: '#/components/schemas/FiltersItem' new_matched: type: integer required: - message - current_page - result_count - total_results - total_pages - data - new_matched GetScanResultStatsResponse: description: Example response content: application/json: schema: type: object properties: message: type: string stats: $ref: '#/components/schemas/ScanStats' required: - message SetScanScheduleResponse: description: Example response content: application/json: schema: type: object properties: message: type: string required: - message GetScanScheduleResponse: description: Example response content: application/json: schema: type: object properties: message: type: string schedules: type: array items: $ref: '#/components/schemas/ScanSchedule' required: - message - schedules PatchAssetContentResponse: description: Example response content: application/json: schema: type: object properties: message: type: string update_status: type: string required: - message GetUserTemplateListResponse: description: Example response content: application/json: schema: type: object properties: data: type: array items: $ref: '#/components/schemas/templateListItem' message: type: string required: - data - message GetShareStatusResponse: description: Example response content: application/json: schema: type: object properties: is_public: type: boolean template_identifier: type: string message: type: string required: - message DeleteScanScheduleResponse: description: Example response content: application/json: schema: type: object properties: message: type: string required: - message PostApiKeyRotateResponse: description: Example response content: application/json: schema: type: object properties: message: type: string api_key: type: string required: - message - api_key MessageResponse: description: Example response content: application/json: schema: type: object properties: message: type: string required: - message PatchUserProfileResponse: description: Example response content: application/json: schema: type: object properties: message: type: string ai_status: type: boolean scan_status: type: boolean static_scan: type: boolean early_template: type: boolean required: - message PostCreateUserResponse: description: Example response content: application/json: schema: type: object properties: message: type: string ai_status: type: boolean scan_status: type: boolean static_scan: type: boolean early_template: type: boolean user_id: type: integer name: type: string email: type: string role: type: string required: - message PostRescanVulnResponse: description: Example response content: application/json: schema: type: object properties: message: type: string results: $ref: '#/components/schemas/VulnerabilityResultsOld' required: - message GetEarlyTempateList: description: Early Template Response content: application/json: schema: type: object properties: version: type: string data: type: array items: $ref: '#/components/schemas/EarlyTemplateListItem' required: - version - data UpdateTeamResponse: description: Example response content: application/json: schema: type: object properties: name: type: string message: type: string required: - message GetTeamResponse: description: Get the workspace details content: application/json: schema: type: object properties: workspaces: type: array items: $ref: '#/components/schemas/WorkspaceItem' message: type: string name: type: string required: - message GetTeamMembersResponse: description: Example response content: application/json: schema: type: object properties: message: type: string max_team_members: type: integer members: type: array items: $ref: '#/components/schemas/TeamMemberItem' required: - message - members - max_team_members StaticScanIPsResponse: description: '' content: application/json: schema: type: object properties: ips: type: array items: type: object required: - ip properties: ip: type: string required: - ips GetEnumerateIdContents: description: Example response content: application/json: schema: type: object properties: current_page: type: integer result_count: type: integer total_results: type: integer total_pages: type: integer message: type: string data: type: array items: $ref: '#/components/schemas/EnumerationContent' required: - message - current_page - result_count - total_results - total_pages - data GetEnumerateIdContentsResponse: description: Example response content: application/json: schema: type: object properties: message: type: string data: $ref: '#/components/schemas/EnumerateData' required: - message - data GetEnumerationScheduleResponse: description: Example response content: application/json: schema: type: object properties: message: type: string schedules: type: array items: $ref: '#/components/schemas/EnumerationSchedule' required: - message - schedules VerifyConfigResponse: description: Example response content: application/json: schema: type: object properties: is_verified: type: boolean response: type: string required: - is_verified - response VerifyConfigContentsResponse: description: Example response content: application/json: schema: type: object properties: jira: type: array items: type: object $ref: '#/components/schemas/JiraVerifyContentItem' ScanStatsResponse: description: Example response content: application/json: schema: type: object properties: scan_stats: type: object properties: total_scan: type: integer total_unique_scan: type: integer total_uploaded_scan: type: integer total_scheduled_scan: type: integer required: - total_scan - total_unique_scan - total_uploaded_scan - total_scheduled_scan scan_status: type: object properties: failed: type: integer finished: type: integer queued: type: integer running: type: integer starting: type: integer stopped: type: integer uploaded: type: integer required: - failed - finished - queued - running - starting - stopped - uploaded required: - scan_stats - scan_status GetScansHistoryResponse: description: Example response content: application/json: schema: type: object properties: message: type: string current_page: type: integer result_count: type: integer total_results: type: integer total_pages: type: integer data: type: array items: $ref: '#/components/schemas/ScansHistoryItems' total_completed_request: type: integer total_scan_run: type: integer total_unique_scan_run: type: integer required: - current_page - result_count - total_results - total_pages - message - data EnumerateResponse: description: Example response content: application/json: schema: type: object properties: current_page: type: integer result_count: type: integer total_results: type: integer total_pages: type: integer data: type: array items: $ref: '#/components/schemas/EnumerateData' required: - current_page - result_count - total_results - total_pages - data PostScanConfigResponse: description: Example response content: application/json: schema: type: object properties: id: type: string message: type: string required: - message ErrorResponse: description: Example response content: application/json: schema: type: object properties: message: type: string kind: type: string code: type: string error: type: string error_id: type: string param: type: string status: type: integer required: - message VulnsTrackerExportResponse: description: Example response content: application/json: schema: type: object properties: ok: type: boolean vuln_id: type: string reporting_config_id: type: string reporting_config_name: type: string ticket_url: type: string ticket_id: type: string tracker_name: type: string required: - ok - vuln_id - reporting_config_id - reporting_config_name - ticket_url - ticket_id - tracker_name ExcludedTemplateResponse: description: Example response content: application/json: schema: type: object properties: data: type: array items: $ref: '#/components/schemas/ExcludedTemplate' required: - data GetScansTokenResponse: description: Example response content: application/json: schema: type: object properties: scan_tokens: type: integer format: int64 used_scan_token: type: integer format: int64 remaining_scan_token: type: integer format: int64 base_domain_count: type: integer format: int64 remaining_domain_count: type: integer format: int64 is_scannable: type: boolean start_date: type: string format: date-time end_date: type: string format: date-time expire_date: type: string format: date-time subscription_type: enum: - BASIC - TRIAL - CUSTOM - PRO required: - scan_tokens - used_scan_token - remaining_scan_token - is_scannable - start_date - end_date - subscription_type - base_domain_count - remaining_domain_count - expire_date GetAssetResponse: description: Example response content: application/json: schema: type: object properties: id: type: integer format: int64 enumeration_id: type: string name: type: string created_at: type: string format: date-time updated_at: type: string format: date-time status_code: type: integer technologies: type: array items: type: string webserver: type: string request: type: string response: type: string cname: type: array items: type: string labels: type: array items: type: string ip: type: string content_length: type: integer title: type: string host: type: string port: type: integer technology_details: type: string format: json is_new: type: boolean required: - id - enumeration_id - name - created_at - updated_at EnumerationStatsResponse: description: Example response content: application/json: schema: type: object properties: asset_stats: $ref: '#/components/schemas/AssetStats' enumeration_stats: $ref: '#/components/schemas/EnumerationCounts' required: - asset_stats PriceListResponse: description: Example response content: application/json: schema: type: object properties: list: type: array items: $ref: '#/components/schemas/PriceListItem' message: type: string required: - list - message GetScanTokenErrorResponse: description: Example response content: application/json: schema: type: object properties: message: type: string subscription_type: type: string required: - message - subscription_type UsageResponse: description: Example response content: application/json: schema: type: object properties: message: type: string cvemap: $ref: '#/components/schemas/ServiceUsageItem' chaos: $ref: '#/components/schemas/ServiceUsageItem' asnmap: $ref: '#/components/schemas/ServiceUsageItem' required: - message GetEnumerateFiltersResponse: description: Example response content: application/json: schema: type: object properties: message: type: string current_page: type: integer result_count: type: integer total_results: type: integer total_pages: type: integer data: type: array items: $ref: '#/components/schemas/EnumerateFiltersItem' required: - message - current_page - result_count - total_results - total_pages - data GetUserTunnelResponse: description: Example response content: application/json: schema: type: object properties: message: type: string tunnels: type: array items: $ref: '#/components/schemas/TunnelItem' required: - message ExposureMetricsResponse: description: Example response content: application/json: schema: type: object properties: total_assets: type: integer new_assets: type: integer unique_technologies: type: integer new_technologies: type: integer time_series: type: array items: $ref: '#/components/schemas/ExposuresTimeSeries' securitySchemes: X-API-Key: name: X-API-Key type: apiKey in: header security: - X-API-Key: [] x-internal: false