AnomalyArmor Public Investigations API

The public-investigations API from AnomalyArmor — 6 operation(s) for public-investigations.

Operations 7

POST /api/v1/sdk/alerts/investigations Trigger Investigation #
GET /api/v1/sdk/alerts/investigations List Investigations #
POST /api/v1/sdk/alerts/investigations/{investigation_id}/reinvestigate Reinvestigate #
GET /api/v1/sdk/alerts/investigations/{investigation_id} Get Investigation #
POST /api/v1/sdk/alerts/investigations/bulk Bulk Investigate #
POST /api/v1/sdk/alerts/investigations/{investigation_id}/feedback Submit Investigation Feedback #
POST /api/v1/sdk/alerts/investigations/explain Explain Asset #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/anomalyarmor-ai:anomalyarmor-ai-public-investigations-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

anomalyarmor-ai-public-investigations-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Anomalyarmor Ai Public Investigations API
  version: 1.0.0
  contact:
    name: AnomalyArmor Support
    url: https://anomalyarmor.ai/support
  license:
    name: Proprietary
  description: 'Operations tagged public-investigations across 3 of this provider''s published API definitions: anomalyarmor.ai-openapi.json, app.anomalyarmor.ai-openapi.json, docs.anomalyarmor.ai-openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- url: http://localhost:8000
  description: Development server
- url: https://api.anomalyarmor.ai
  description: Production server
tags:
- name: public-investigations
paths:
  /api/v1/sdk/alerts/investigations:
    post:
      tags:
      - public-investigations
      summary: Trigger Investigation
      description: 'Trigger an investigation for an alert.


        Returns immediately with investigation ID. Poll GET /investigations/{id}

        for results. Investigation runs asynchronously (typically completes in <30s).'
      operationId: trigger_investigation_api_v1_sdk_alerts_investigations_post
      parameters:
      - name: Authorization
        in: header
        required: false
        schema:
          type: string
          title: Authorization
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TriggerInvestigationRequest'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StandardResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    get:
      tags:
      - public-investigations
      summary: List Investigations
      description: List investigations for the company.
      operationId: list_investigations_api_v1_sdk_alerts_investigations_get
      parameters:
      - name: status
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: Filter by status
          title: Status
        description: Filter by status
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          maximum: 100
          minimum: 1
          default: 50
          title: Limit
      - name: offset
        in: query
        required: false
        schema:
          type: integer
          minimum: 0
          default: 0
          title: Offset
      - name: Authorization
        in: header
        required: false
        schema:
          type: string
          title: Authorization
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StandardResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    servers:
    - url: http://localhost:8000
      description: Development server
    - url: https://api.anomalyarmor.ai
      description: Production server
  /api/v1/sdk/alerts/investigations/{investigation_id}/reinvestigate:
    post:
      tags:
      - public-investigations
      summary: Reinvestigate
      description: 'Re-run investigation with fresh data.


        Marks the previous investigation as superseded and creates a new one.'
      operationId: reinvestigate_api_v1_sdk_alerts_investigations__investigation_id__reinvestigate_post
      parameters:
      - name: investigation_id
        in: path
        required: true
        schema:
          type: string
          title: Investigation Id
      - name: Authorization
        in: header
        required: false
        schema:
          type: string
          title: Authorization
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StandardResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    servers:
    - url: http://localhost:8000
      description: Development server
    - url: https://api.anomalyarmor.ai
      description: Production server
  /api/v1/sdk/alerts/investigations/{investigation_id}:
    get:
      tags:
      - public-investigations
      summary: Get Investigation
      description: Get investigation results by investigation ID.
      operationId: get_investigation_api_v1_sdk_alerts_investigations__investigation_id__get
      parameters:
      - name: investigation_id
        in: path
        required: true
        schema:
          type: string
          title: Investigation Id
      - name: Authorization
        in: header
        required: false
        schema:
          type: string
          title: Authorization
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StandardResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    servers:
    - url: http://localhost:8000
      description: Development server
    - url: https://api.anomalyarmor.ai
      description: Production server
  /api/v1/sdk/alerts/investigations/bulk:
    post:
      tags:
      - public-investigations
      summary: Bulk Investigate
      description: 'Trigger investigations for multiple alerts (max 20).


        Returns investigation IDs for each. Investigations run in parallel.'
      operationId: bulk_investigate_api_v1_sdk_alerts_investigations_bulk_post
      parameters:
      - name: Authorization
        in: header
        required: false
        schema:
          type: string
          title: Authorization
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BulkInvestigateRequest'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StandardResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    servers:
    - url: http://localhost:8000
      description: Development server
    - url: https://api.anomalyarmor.ai
      description: Production server
  /api/v1/sdk/alerts/investigations/{investigation_id}/feedback:
    post:
      tags:
      - public-investigations
      summary: Submit Investigation Feedback
      description: Submit feedback on investigation quality.
      operationId: submit_investigation_feedback_api_v1_sdk_alerts_investigations__investigation_id__feedback_post
      parameters:
      - name: investigation_id
        in: path
        required: true
        schema:
          type: string
          title: Investigation Id
      - name: Authorization
        in: header
        required: false
        schema:
          type: string
          title: Authorization
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/InvestigationFeedbackRequest'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StandardResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    servers:
    - url: http://localhost:8000
      description: Development server
    - url: https://api.anomalyarmor.ai
      description: Production server
  /api/v1/sdk/alerts/investigations/explain:
    post:
      tags:
      - public-investigations
      summary: Explain Asset
      description: 'TECH-982: synchronous asset investigation returning an EvidenceCapsule.


        Runs the same correlator pipeline as alert-driven investigations but

        does not persist an AlertInvestigation row. Use when you have an

        asset and a question but no firing alert.'
      operationId: explain_asset_api_v1_sdk_alerts_investigations_explain_post
      parameters:
      - name: Authorization
        in: header
        required: false
        schema:
          type: string
          title: Authorization
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ExplainAssetRequest'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StandardResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    servers:
    - url: http://localhost:8000
      description: Development server
    - url: https://api.anomalyarmor.ai
      description: Production server
components:
  schemas:
    InvestigationFeedbackRequest:
      properties:
        is_helpful:
          type: boolean
          title: Is Helpful
          description: Whether the investigation was helpful
        comment:
          anyOf:
          - type: string
            maxLength: 2000
          - type: 'null'
          title: Comment
          description: Optional feedback comment
      type: object
      required:
      - is_helpful
      title: InvestigationFeedbackRequest
      description: Request to submit investigation feedback.
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    TriggerInvestigationRequest:
      properties:
        alert_id:
          type: string
          title: Alert Id
          description: Alert public UUID to investigate
      type: object
      required:
      - alert_id
      title: TriggerInvestigationRequest
      description: Request to trigger an on-demand investigation.
    BulkInvestigateRequest:
      properties:
        alert_ids:
          items:
            type: string
          type: array
          maxItems: 20
          minItems: 1
          title: Alert Ids
          description: Alert public UUIDs (max 20)
      type: object
      required:
      - alert_ids
      title: BulkInvestigateRequest
      description: Request to trigger investigations for multiple alerts.
    StandardResponse:
      properties:
        success:
          type: boolean
          title: Success
        data:
          anyOf:
          - {}
          - type: 'null'
          title: Data
        message:
          anyOf:
          - type: string
          - type: 'null'
          title: Message
        error:
          anyOf:
          - type: string
          - type: 'null'
          title: Error
        meta:
          anyOf:
          - additionalProperties: true
            type: object
          - type: 'null'
          title: Meta
      type: object
      required:
      - success
      title: StandardResponse
      description: Standard API response wrapper.
    ExplainAssetRequest:
      properties:
        asset_id:
          type: string
          title: Asset Id
          description: Asset public UUID
        question:
          anyOf:
          - type: string
            maxLength: 500
          - type: 'null'
          title: Question
          description: Natural-language question to anchor the capsule
        event_type:
          type: string
          title: Event Type
          description: 'One of: anomaly, freshness, schema_change, validity'
          default: anomaly
      type: object
      required:
      - asset_id
      title: ExplainAssetRequest
      description: 'TECH-982: request body for `POST /alerts/investigations/explain`.


        Run a synchronous investigation against an asset without persisting a

        row. Used by the `armor-investigate` skill.'
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
            - type: string
            - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
      - loc
      - msg
      - type
      title: ValidationError
x-refined-from:
- anomalyarmor.ai-openapi.json
- app.anomalyarmor.ai-openapi.json
- docs.anomalyarmor.ai-openapi.json