Trigger

POST

/v1/{alarmId}/trigger

const url = 'https://api.openalarm.io/v1/k7m3x9q2f8d4w1b5/trigger';
const options = {method: 'POST', headers: {'X-API-Key': '<X-API-Key>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request POST \
  --url https://api.openalarm.io/v1/k7m3x9q2f8d4w1b5/trigger \
  --header 'X-API-Key: <X-API-Key>'

Fire the alarm using its stored mode policy, falling back to Away if no mode was ever armed. Always fireable - never depends on a prior arm.

Authorizations

ApiKeyHeader
BearerAuth

Parameters

Path Parameters

alarmId

required

string

The alarm’s identifier. The API key gates the call; this names which alarm it acts on.

Example

k7m3x9q2f8d4w1b5

Responses

401

The API key is missing or invalid.

403

Unauthorized.

404

Alarm ID not found.

2XX

The event was accepted. Pre-release: the exact success status code and response body are being finalized and are not documented yet.