> ## Documentation Index
> Fetch the complete documentation index at: https://docs.events.intrace.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Trigger Scan

> Trigger an immediate monitoring scan across current assets

Starts an immediate scan for the tenant or monitored portfolio.

## Suggested request shape

```json theme={null}
{
  "asset_ids": ["lagos-hq", "abuja-residence-1"],
  "lookback_hours": 24
}
```

## Response

```json theme={null}
{
  "status": "scan_started"
}
```


## OpenAPI

````yaml post /v1/threats/scan
openapi: 3.1.0
info:
  title: Intrace Events Monitoring API
  version: 0.1.0
  description: >
    External asset monitoring and event intelligence API derived from the
    internal

    Intrace events investigations platform.


    This public API is tenant-scoped by API key and intentionally does not
    expose

    internal identifiers such as case_id or investigation_id.
servers:
  - url: https://api.intrace.ai
security:
  - ApiKeyAuth: []
tags:
  - name: Assets
  - name: Threats
  - name: Incidents
  - name: Alerts
  - name: Reports
  - name: Event Intelligence
paths:
  /v1/threats/scan:
    post:
      tags:
        - Threats
      summary: Trigger scan
      operationId: triggerThreatScan
      requestBody:
        required: false
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TriggerScanRequest'
      responses:
        '202':
          description: Scan accepted.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TriggerScanResponse'
components:
  schemas:
    TriggerScanRequest:
      type: object
      properties:
        asset_ids:
          type: array
          items:
            type: string
        lookback_hours:
          type: integer
          minimum: 1
      additionalProperties: false
    TriggerScanResponse:
      type: object
      properties:
        status:
          type: string
      required:
        - status
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key

````