ZAP API — search

naftiko: 1.0.0-alpha2
info:
  label: ZAP API — search
  description: 'ZAP API — search. 18 operations. Lead operation: search. Self-contained Naftiko capability covering one Owasp
    Zap business surface.'
  tags:
  - Owasp Zap
  - search
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    OWASP_ZAP_API_KEY: OWASP_ZAP_API_KEY
capability:
  consumes:
  - type: http
    namespace: owasp-zap-search
    baseUri: http://zap
    description: ZAP API — search business capability. Self-contained, no shared references.
    resources:
    - name: JSON-search-view-messagesByHeaderRegex
      path: /JSON/search/view/messagesByHeaderRegex/
      operations:
      - name: searchviewmessagesbyheaderregex
        method: GET
        description: Returns the HTTP messages that match the given regular expression in the header(s) optionally filtered
          by URL and paginated with 'start' position and 'count' of messages.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: JSON-search-view-messagesByNoteRegex
      path: /JSON/search/view/messagesByNoteRegex/
      operations:
      - name: searchviewmessagesbynoteregex
        method: GET
        description: Returns the HTTP messages that match the given regular expression in their note optionally filtered by
          URL and paginated with 'start' position and 'count' of messages.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: JSON-search-view-messagesByRequestRegex
      path: /JSON/search/view/messagesByRequestRegex/
      operations:
      - name: searchviewmessagesbyrequestregex
        method: GET
        description: Returns the HTTP messages that match the given regular expression in the request optionally filtered
          by URL and paginated with 'start' position and 'count' of messages.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: JSON-search-view-messagesByResponseRegex
      path: /JSON/search/view/messagesByResponseRegex/
      operations:
      - name: searchviewmessagesbyresponseregex
        method: GET
        description: Returns the HTTP messages that match the given regular expression in the response optionally filtered
          by URL and paginated with 'start' position and 'count' of messages.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: JSON-search-view-messagesByTagRegex
      path: /JSON/search/view/messagesByTagRegex/
      operations:
      - name: searchviewmessagesbytagregex
        method: GET
        description: Returns the HTTP messages that match the given regular expression in their history Tags optionally filtered
          by URL and paginated with 'start' position and 'count' of messages.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: JSON-search-view-messagesByUrlRegex
      path: /JSON/search/view/messagesByUrlRegex/
      operations:
      - name: searchviewmessagesbyurlregex
        method: GET
        description: Returns the HTTP messages that match the given regular expression in the URL optionally filtered by URL
          and paginated with 'start' position and 'count' of messages.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: JSON-search-view-urlsByHeaderRegex
      path: /JSON/search/view/urlsByHeaderRegex/
      operations:
      - name: searchviewurlsbyheaderregex
        method: GET
        description: Returns the URLs of the HTTP messages that match the given regular expression in the header(s) optionally
          filtered by URL and paginated with 'start' position and 'count' of messages.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: JSON-search-view-urlsByNoteRegex
      path: /JSON/search/view/urlsByNoteRegex/
      operations:
      - name: searchviewurlsbynoteregex
        method: GET
        description: Returns the URLs of the HTTP messages that match the given regular expression in their note optionally
          filtered by URL and paginated with 'start' position and 'count' of messages.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: JSON-search-view-urlsByRequestRegex
      path: /JSON/search/view/urlsByRequestRegex/
      operations:
      - name: searchviewurlsbyrequestregex
        method: GET
        description: Returns the URLs of the HTTP messages that match the given regular expression in the request optionally
          filtered by URL and paginated with 'start' position and 'count' of messages.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: JSON-search-view-urlsByResponseRegex
      path: /JSON/search/view/urlsByResponseRegex/
      operations:
      - name: searchviewurlsbyresponseregex
        method: GET
        description: Returns the URLs of the HTTP messages that match the given regular expression in the response optionally
          filtered by URL and paginated with 'start' position and 'count' of messages.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: JSON-search-view-urlsByTagRegex
      path: /JSON/search/view/urlsByTagRegex/
      operations:
      - name: searchviewurlsbytagregex
        method: GET
        description: Returns the URLs of the HTTP messages that match the given regular expression in their history Tags optionally
          filtered by URL and paginated with 'start' position and 'count' of messages.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: JSON-search-view-urlsByUrlRegex
      path: /JSON/search/view/urlsByUrlRegex/
      operations:
      - name: searchviewurlsbyurlregex
        method: GET
        description: Returns the URLs of the HTTP messages that match the given regular expression in the URL optionally filtered
          by URL and paginated with 'start' position and 'count' of messages.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: OTHER-search-other-harByHeaderRegex
      path: /OTHER/search/other/harByHeaderRegex/
      operations:
      - name: searchotherharbyheaderregex
        method: GET
        description: Returns the HTTP messages, in HAR format, that match the given regular expression in the header(s) optionally
          filtered by URL and paginated with 'start' position and 'count' of messages.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: OTHER-search-other-harByNoteRegex
      path: /OTHER/search/other/harByNoteRegex/
      operations:
      - name: searchotherharbynoteregex
        method: GET
        description: Returns the HTTP messages, in HAR format, that match the given regular expression in their note optionally
          filtered by URL and paginated with 'start' position and 'count' of messages.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: OTHER-search-other-harByRequestRegex
      path: /OTHER/search/other/harByRequestRegex/
      operations:
      - name: searchotherharbyrequestregex
        method: GET
        description: Returns the HTTP messages, in HAR format, that match the given regular expression in the request optionally
          filtered by URL and paginated with 'start' position and 'count' of messages.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: OTHER-search-other-harByResponseRegex
      path: /OTHER/search/other/harByResponseRegex/
      operations:
      - name: searchotherharbyresponseregex
        method: GET
        description: Returns the HTTP messages, in HAR format, that match the given regular expression in the response optionally
          filtered by URL and paginated with 'start' position and 'count' of messages.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: OTHER-search-other-harByTagRegex
      path: /OTHER/search/other/harByTagRegex/
      operations:
      - name: searchotherharbytagregex
        method: GET
        description: Returns the HTTP messages, in HAR format, that match the given regular expression in their history Tags
          optionally filtered by URL and paginated with 'start' position and 'count' of messages.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: OTHER-search-other-harByUrlRegex
      path: /OTHER/search/other/harByUrlRegex/
      operations:
      - name: searchotherharbyurlregex
        method: GET
        description: Returns the HTTP messages, in HAR format, that match the given regular expression in the URL optionally
          filtered by URL and paginated with 'start' position and 'count' of messages.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    authentication:
      type: apikey
      key: X-ZAP-API-Key
      value: '{{env.OWASP_ZAP_API_KEY}}'
      placement: header
  exposes:
  - type: rest
    namespace: owasp-zap-search-rest
    port: 8080
    description: REST adapter for ZAP API — search. One Spectral-compliant resource per consumed operation, prefixed with
      /v1.
    resources:
    - path: /v1/json/search/view/messagesbyheaderregex
      name: json-search-view-messagesbyheaderregex
      description: REST surface for JSON-search-view-messagesByHeaderRegex.
      operations:
      - method: GET
        name: searchviewmessagesbyheaderregex
        description: Returns the HTTP messages that match the given regular expression in the header(s) optionally filtered
          by URL and paginated with 'start' position and 'count' of messages.
        call: owasp-zap-search.searchviewmessagesbyheaderregex
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/json/search/view/messagesbynoteregex
      name: json-search-view-messagesbynoteregex
      description: REST surface for JSON-search-view-messagesByNoteRegex.
      operations:
      - method: GET
        name: searchviewmessagesbynoteregex
        description: Returns the HTTP messages that match the given regular expression in their note optionally filtered by
          URL and paginated with 'start' position and 'count' of messages.
        call: owasp-zap-search.searchviewmessagesbynoteregex
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/json/search/view/messagesbyrequestregex
      name: json-search-view-messagesbyrequestregex
      description: REST surface for JSON-search-view-messagesByRequestRegex.
      operations:
      - method: GET
        name: searchviewmessagesbyrequestregex
        description: Returns the HTTP messages that match the given regular expression in the request optionally filtered
          by URL and paginated with 'start' position and 'count' of messages.
        call: owasp-zap-search.searchviewmessagesbyrequestregex
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/json/search/view/messagesbyresponseregex
      name: json-search-view-messagesbyresponseregex
      description: REST surface for JSON-search-view-messagesByResponseRegex.
      operations:
      - method: GET
        name: searchviewmessagesbyresponseregex
        description: Returns the HTTP messages that match the given regular expression in the response optionally filtered
          by URL and paginated with 'start' position and 'count' of messages.
        call: owasp-zap-search.searchviewmessagesbyresponseregex
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/json/search/view/messagesbytagregex
      name: json-search-view-messagesbytagregex
      description: REST surface for JSON-search-view-messagesByTagRegex.
      operations:
      - method: GET
        name: searchviewmessagesbytagregex
        description: Returns the HTTP messages that match the given regular expression in their history Tags optionally filtered
          by URL and paginated with 'start' position and 'count' of messages.
        call: owasp-zap-search.searchviewmessagesbytagregex
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/json/search/view/messagesbyurlregex
      name: json-search-view-messagesbyurlregex
      description: REST surface for JSON-search-view-messagesByUrlRegex.
      operations:
      - method: GET
        name: searchviewmessagesbyurlregex
        description: Returns the HTTP messages that match the given regular expression in the URL optionally filtered by URL
          and paginated with 'start' position and 'count' of messages.
        call: owasp-zap-search.searchviewmessagesbyurlregex
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/json/search/view/urlsbyheaderregex
      name: json-search-view-urlsbyheaderregex
      description: REST surface for JSON-search-view-urlsByHeaderRegex.
      operations:
      - method: GET
        name: searchviewurlsbyheaderregex
        description: Returns the URLs of the HTTP messages that match the given regular expression in the header(s) optionally
          filtered by URL and paginated with 'start' position and 'count' of messages.
        call: owasp-zap-search.searchviewurlsbyheaderregex
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/json/search/view/urlsbynoteregex
      name: json-search-view-urlsbynoteregex
      description: REST surface for JSON-search-view-urlsByNoteRegex.
      operations:
      - method: GET
        name: searchviewurlsbynoteregex
        description: Returns the URLs of the HTTP messages that match the given regular expression in their note optionally
          filtered by URL and paginated with 'start' position and 'count' of messages.
        call: owasp-zap-search.searchviewurlsbynoteregex
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/json/search/view/urlsbyrequestregex
      name: json-search-view-urlsbyrequestregex
      description: REST surface for JSON-search-view-urlsByRequestRegex.
      operations:
      - method: GET
        name: searchviewurlsbyrequestregex
        description: Returns the URLs of the HTTP messages that match the given regular expression in the request optionally
          filtered by URL and paginated with 'start' position and 'count' of messages.
        call: owasp-zap-search.searchviewurlsbyrequestregex
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/json/search/view/urlsbyresponseregex
      name: json-search-view-urlsbyresponseregex
      description: REST surface for JSON-search-view-urlsByResponseRegex.
      operations:
      - method: GET
        name: searchviewurlsbyresponseregex
        description: Returns the URLs of the HTTP messages that match the given regular expression in the response optionally
          filtered by URL and paginated with 'start' position and 'count' of messages.
        call: owasp-zap-search.searchviewurlsbyresponseregex
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/json/search/view/urlsbytagregex
      name: json-search-view-urlsbytagregex
      description: REST surface for JSON-search-view-urlsByTagRegex.
      operations:
      - method: GET
        name: searchviewurlsbytagregex
        description: Returns the URLs of the HTTP messages that match the given regular expression in their history Tags optionally
          filtered by URL and paginated with 'start' position and 'count' of messages.
        call: owasp-zap-search.searchviewurlsbytagregex
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/json/search/view/urlsbyurlregex
      name: json-search-view-urlsbyurlregex
      description: REST surface for JSON-search-view-urlsByUrlRegex.
      operations:
      - method: GET
        name: searchviewurlsbyurlregex
        description: Returns the URLs of the HTTP messages that match the given regular expression in the URL optionally filtered
          by URL and paginated with 'start' position and 'count' of messages.
        call: owasp-zap-search.searchviewurlsbyurlregex
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/other/search/other/harbyheaderregex
      name: other-search-other-harbyheaderregex
      description: REST surface for OTHER-search-other-harByHeaderRegex.
      operations:
      - method: GET
        name: searchotherharbyheaderregex
        description: Returns the HTTP messages, in HAR format, that match the given regular expression in the header(s) optionally
          filtered by URL and paginated with 'start' position and 'count' of messages.
        call: owasp-zap-search.searchotherharbyheaderregex
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/other/search/other/harbynoteregex
      name: other-search-other-harbynoteregex
      description: REST surface for OTHER-search-other-harByNoteRegex.
      operations:
      - method: GET
        name: searchotherharbynoteregex
        description: Returns the HTTP messages, in HAR format, that match the given regular expression in their note optionally
          filtered by URL and paginated with 'start' position and 'count' of messages.
        call: owasp-zap-search.searchotherharbynoteregex
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/other/search/other/harbyrequestregex
      name: other-search-other-harbyrequestregex
      description: REST surface for OTHER-search-other-harByRequestRegex.
      operations:
      - method: GET
        name: searchotherharbyrequestregex
        description: Returns the HTTP messages, in HAR format, that match the given regular expression in the request optionally
          filtered by URL and paginated with 'start' position and 'count' of messages.
        call: owasp-zap-search.searchotherharbyrequestregex
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/other/search/other/harbyresponseregex
      name: other-search-other-harbyresponseregex
      description: REST surface for OTHER-search-other-harByResponseRegex.
      operations:
      - method: GET
        name: searchotherharbyresponseregex
        description: Returns the HTTP messages, in HAR format, that match the given regular expression in the response optionally
          filtered by URL and paginated with 'start' position and 'count' of messages.
        call: owasp-zap-search.searchotherharbyresponseregex
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/other/search/other/harbytagregex
      name: other-search-other-harbytagregex
      description: REST surface for OTHER-search-other-harByTagRegex.
      operations:
      - method: GET
        name: searchotherharbytagregex
        description: Returns the HTTP messages, in HAR format, that match the given regular expression in their history Tags
          optionally filtered by URL and paginated with 'start' position and 'count' of messages.
        call: owasp-zap-search.searchotherharbytagregex
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/other/search/other/harbyurlregex
      name: other-search-other-harbyurlregex
      description: REST surface for OTHER-search-other-harByUrlRegex.
      operations:
      - method: GET
        name: searchotherharbyurlregex
        description: Returns the HTTP messages, in HAR format, that match the given regular expression in the URL optionally
          filtered by URL and paginated with 'start' position and 'count' of messages.
        call: owasp-zap-search.searchotherharbyurlregex
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: owasp-zap-search-mcp
    port: 9090
    transport: http
    description: MCP adapter for ZAP API — search. One tool per consumed operation, routed inline through this capability's
      consumes block.
    tools:
    - name: returns-http-messages-that-match
      description: Returns the HTTP messages that match the given regular expression in the header(s) optionally filtered
        by URL and paginated with 'start' position and 'count' of messages.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: owasp-zap-search.searchviewmessagesbyheaderregex
      outputParameters:
      - type: object
        mapping: $.
    - name: returns-http-messages-that-match-2
      description: Returns the HTTP messages that match the given regular expression in their note optionally filtered by
        URL and paginated with 'start' position and 'count' of messages.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: owasp-zap-search.searchviewmessagesbynoteregex
      outputParameters:
      - type: object
        mapping: $.
    - name: returns-http-messages-that-match-3
      description: Returns the HTTP messages that match the given regular expression in the request optionally filtered by
        URL and paginated with 'start' position and 'count' of messages.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: owasp-zap-search.searchviewmessagesbyrequestregex
      outputParameters:
      - type: object
        mapping: $.
    - name: returns-http-messages-that-match-4
      description: Returns the HTTP messages that match the given regular expression in the response optionally filtered by
        URL and paginated with 'start' position and 'count' of messages.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: owasp-zap-search.searchviewmessagesbyresponseregex
      outputParameters:
      - type: object
        mapping: $.
    - name: returns-http-messages-that-match-5
      description: Returns the HTTP messages that match the given regular expression in their history Tags optionally filtered
        by URL and paginated with 'start' position and 'count' of messages.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: owasp-zap-search.searchviewmessagesbytagregex
      outputParameters:
      - type: object
        mapping: $.
    - name: returns-http-messages-that-match-6
      description: Returns the HTTP messages that match the given regular expression in the URL optionally filtered by URL
        and paginated with 'start' position and 'count' of messages.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: owasp-zap-search.searchviewmessagesbyurlregex
      outputParameters:
      - type: object
        mapping: $.
    - name: returns-urls-http-messages-that
      description: Returns the URLs of the HTTP messages that match the given regular expression in the header(s) optionally
        filtered by URL and paginated with 'start' position and 'count' of messages.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: owasp-zap-search.searchviewurlsbyheaderregex
      outputParameters:
      - type: object
        mapping: $.
    - name: returns-urls-http-messages-that-2
      description: Returns the URLs of the HTTP messages that match the given regular expression in their note optionally
        filtered by URL and paginated with 'start' position and 'count' of messages.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: owasp-zap-search.searchviewurlsbynoteregex
      outputParameters:
      - type: object
        mapping: $.
    - name: returns-urls-http-messages-that-3
      description: Returns the URLs of the HTTP messages that match the given regular expression in the request optionally
        filtered by URL and paginated with 'start' position and 'count' of messages.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: owasp-zap-search.searchviewurlsbyrequestregex
      outputParameters:
      - type: object
        mapping: $.
    - name: returns-urls-http-messages-that-4
      description: Returns the URLs of the HTTP messages that match the given regular expression in the response optionally
        filtered by URL and paginated with 'start' position and 'count' of messages.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: owasp-zap-search.searchviewurlsbyresponseregex
      outputParameters:
      - type: object
        mapping: $.
    - name: returns-urls-http-messages-that-5
      description: Returns the URLs of the HTTP messages that match the given regular expression in their history Tags optionally
        filtered by URL and paginated with 'start' position and 'count' of messages.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: owasp-zap-search.searchviewurlsbytagregex
      outputParameters:
      - type: object
        mapping: $.
    - name: returns-urls-http-messages-that-6
      description: Returns the URLs of the HTTP messages that match the given regular expression in the URL optionally filtered
        by URL and paginated with 'start' position and 'count' of messages.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: owasp-zap-search.searchviewurlsbyurlregex
      outputParameters:
      - type: object
        mapping: $.
    - name: returns-http-messages-har-format
      description: Returns the HTTP messages, in HAR format, that match the given regular expression in the header(s) optionally
        filtered by URL and paginated with 'start' position and 'count' of messages.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: owasp-zap-search.searchotherharbyheaderregex
      outputParameters:
      - type: object
        mapping: $.
    - name: returns-http-messages-har-format-2
      description: Returns the HTTP messages, in HAR format, that match the given regular expression in their note optionally
        filtered by URL and paginated with 'start' position and 'count' of messages.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: owasp-zap-search.searchotherharbynoteregex
      outputParameters:
      - type: object
        mapping: $.
    - name: returns-http-messages-har-format-3
      description: Returns the HTTP messages, in HAR format, that match the given regular expression in the request optionally
        filtered by URL and paginated with 'start' position and 'count' of messages.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: owasp-zap-search.searchotherharbyrequestregex
      outputParameters:
      - type: object
        mapping: $.
    - name: returns-http-messages-har-format-4
      description: Returns the HTTP messages, in HAR format, that match the given regular expression in the response optionally
        filtered by URL and paginated with 'start' position and 'count' of messages.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: owasp-zap-search.searchotherharbyresponseregex
      outputParameters:
      - type: object
        mapping: $.
    - name: returns-http-messages-har-format-5
      description: Returns the HTTP messages, in HAR format, that match the given regular expression in their history Tags
        optionally filtered by URL and paginated with 'start' position and 'count' of messages.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: owasp-zap-search.searchotherharbytagregex
      outputParameters:
      - type: object
        mapping: $.
    - name: returns-http-messages-har-format-6
      description: Returns the HTTP messages, in HAR format, that match the given regular expression in the URL optionally
        filtered by URL and paginated with 'start' position and 'count' of messages.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: owasp-zap-search.searchotherharbyurlregex
      outputParameters:
      - type: object
        mapping: $.