openapi.yaml

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/*:
    get:
      operationId: get-v1-template-public-path
      summary: Get Public Template
      description: Get public template text using path
      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
      tags:
        - templates
  /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