Create a status signal for an asset by ID

post

https://api.remberg.de/v2/assets/{id}/status-signals

Creates a new status signal for the asset identified by its internal ID. Status signals represent the operational state of an asset (e.g. OK, warning, or error) and can include an optional comment.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

string

required

The asset's internal ID

Body Params

status

string

enum

required

The status of the signal (warning, stopped, inactive)

Allowed:

comment

string

An optional comment for the status signal

reportedAt

date-time

Manual start timestamp (ISO 8601 UTC). Defaults to "now" when omitted.

resolvedAt

date-time

Manual end timestamp (ISO 8601 UTC). When set, the signal is created already resolved.

Headers

remberg-active-site-ref

string

^s[1-9]\d*$

The site the request acts on, e.g. s2. You find it in the remberg web app URL (e.g. /s2/) or next to the site name under Settings → Sites. If your account has access to more than one site, send this header on every request; site-specific requests without it fail with 403 ACTIVE_SITE_UNAVAILABLE. With access to a single site, that site is used when the header is omitted. A site your account cannot access fails with 403 ACTIVE_SITE_UNAVAILABLE; a record that belongs to another site returns 404.

Responses

400

Bad Request

403

Forbidden

404

Not Found

Language

Credentials

Header

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

201Resource created