Update data delivery rule

put

https://api.sensos.io/v1/accounts/{accountId}/data-delivery-rules/{configurationId}

Replace an existing data delivery rule. This is a full replace: send the complete rule. Optional fields that are omitted are cleared, and status reverts to Enabled when omitted. createdAt and createdBy are preserved. Changes take effect within about 15 minutes.

Path Params

accountId

string

required

Unique identifier of the Sensos account.

configurationId

string

required

Unique identifier of the data delivery rule.

Body Params

The complete data delivery rule.

A data delivery rule. Rules apply to every device in the account.

name

string

required

Descriptive name for the rule.

description

string

Optional human-readable description of the rule's purpose.

status

string

enum

Defaults to Enabled

Whether the rule delivers data. Defaults to Enabled when omitted.

Allowed:

dataSourceType

string

enum

required

Type of data the rule delivers. Payload formats:

DeviceReport: Device reports
TemperatureLogging: Temperature logging
HumidityLogging: Humidity logging
Alert: Alerts

Allowed:

skipNoLocationReports

boolean

Applies only to DeviceReport rules. When true, device reports without a location fix are not delivered.

action

object

required

HTTP delivery action. Sensos sends each payload to url using method. Failed deliveries are retried as described in the retry policy.

Responses

401

The access token is missing, invalid or expired. Returned by the gateway with an empty body.

403

The caller has no permission for this operation or account. Returned by the gateway with an empty body.

200Data delivery rule updated.

400The request is invalid. Rule validation errors (for example a missing name, dataSourceType, action.url or an invalid secretKey length) and an invalid cursor return {"error": "<message>"}. Malformed JSON or invalid values for typed fields return a validation problem details body.

404No data delivery rule with this ID exists in the account.