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

# Trigger Alarm Evaluation

> Manually trigger alarm evaluation with current data.

### Headers

**authorization** `string` *required*

Your API key for authentication.

### Path Parameters

**id** `string` *required*

Alarm configuration ID.

### Response

**data.success** `boolean`

Whether the evaluation completed with enough data.

**data.message** `string`

Human-readable result message.

**data.currentMetrics** `object`

Current metric snapshot, when available.

**data.currentMetrics.value** `number`

Current metric value.

**data.currentMetrics.sampleCount** `number`

Number of samples used in evaluation.

**data.currentMetrics.deviation** `number|null`

Deviation from baseline.

**data.currentMetrics.threshold** `number`

Configured threshold for comparison.

```json Success theme={null}
{
  "data": {
    "success": true,
    "message": "Test completed successfully. Current alarm state: NORMAL",
    "currentMetrics": {
      "value": 0.2,
      "sampleCount": 22,
      "deviation": null,
      "threshold": 2.5
    }
  },
  "errors": null
}
```

```json Not Enough Data theme={null}
{
  "data": {
    "success": false,
    "message": "Not enough recent data available. Please wait until there is more data to trigger an alarm."
  },
  "errors": null
}
```

***

Docs for agents: [llms.txt](https://docs.bland.ai/llms.txt)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.