> ## 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.

# Update Asset

> Partially update a monitored asset

Updates only the provided fields.

## Supported fields

* `name`
* `type`
* `role`
* `status`
* `attributes`
* `threat_config`
* `physical_threat_config`

## Example Request

```json theme={null}
{
  "attributes": {
    "lat": 6.4541,
    "lng": 3.3947,
    "monitoring_radius_km": 20
  },
  "physical_threat_config": {
    "enabled": true,
    "custom_instructions": "Prioritize protest escalation and road closures."
  }
}
```


## OpenAPI

````yaml patch /v1/assets/{asset_id}
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/assets/{asset_id}:
    patch:
      tags:
        - Assets
      summary: Update asset
      operationId: updateAsset
      parameters:
        - $ref: '#/components/parameters/AssetId'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AssetUpdateRequest'
      responses:
        '200':
          description: Updated asset.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Asset'
        '404':
          $ref: '#/components/responses/NotFound'
components:
  parameters:
    AssetId:
      name: asset_id
      in: path
      required: true
      schema:
        type: string
  schemas:
    AssetUpdateRequest:
      type: object
      properties:
        type:
          type: string
          enum:
            - facility
            - residence
        name:
          type: string
        role:
          type: string
        status:
          type: string
        attributes:
          $ref: '#/components/schemas/AssetAttributes'
        threat_config:
          $ref: '#/components/schemas/ThreatConfig'
        physical_threat_config:
          $ref: '#/components/schemas/PhysicalThreatConfig'
    Asset:
      type: object
      properties:
        id:
          type: string
          format: uuid
        asset_id:
          type: string
        type:
          type: string
        name:
          type: string
        role:
          type: string
          nullable: true
        status:
          type: string
        attributes:
          $ref: '#/components/schemas/AssetAttributes'
        threat_config:
          $ref: '#/components/schemas/ThreatConfig'
        physical_threat_config:
          $ref: '#/components/schemas/PhysicalThreatConfig'
        created_at:
          type: string
          format: date-time
        updated_at:
          type: string
          format: date-time
      required:
        - id
        - asset_id
        - type
        - name
        - status
        - created_at
        - updated_at
    AssetAttributes:
      type: object
      additionalProperties: true
      properties:
        lat:
          type: number
        lng:
          type: number
        address:
          type: string
        country:
          type: string
        monitoring_radius_km:
          type: number
    ThreatConfig:
      type: object
      additionalProperties: false
      properties:
        enabled:
          type: boolean
          default: true
        alert_classes:
          type: array
          items:
            type: string
            enum:
              - class_1_situational_awareness
              - class_2_potential_threat
              - class_3_direct_threat
        custom_instructions:
          type: string
        monitored_event_types:
          type: array
          items:
            type: string
        lookback_days:
          type: integer
          minimum: 1
          maximum: 90
    PhysicalThreatConfig:
      type: object
      additionalProperties: false
      properties:
        enabled:
          type: boolean
          default: true
        alert_classes:
          type: array
          items:
            type: string
            enum:
              - class_1_situational_awareness
              - class_2_potential_threat
              - class_3_direct_threat
        custom_instructions:
          type: string
        monitored_event_types:
          type: array
          items:
            type: string
        max_age_hours_by_category:
          type: object
          additionalProperties:
            type: integer
  responses:
    NotFound:
      description: Resource not found.
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key

````