Delivery¶

The delivery settings set how long the SMSC attempts delivery of a message, and when it retries a failed delivery. The retention sets how long it keeps a message afterwards.

Get the Delivery Settings¶

This path returns the delivery settings.

Method	Path
GET	`/api/v1/delivery`

Response Fields¶

Field	Type	Description
`default_validity_seconds`	int	How long delivery of a message without its own validity period is attempted, in seconds. The same applies to status reports.
`retry_intervals_seconds`	array	Wait before each retry, in seconds. The last interval repeats. Empty: a failed delivery is not retried.

Sample Response¶

{
    "result": {
        "default_validity_seconds": 604800,
        "retry_intervals_seconds": [60, 300, 900, 3600]
    }
}

Update the Delivery Settings¶

This path replaces the delivery settings. The new validity applies to the messages received afterwards; the new intervals, to the next retries.

Method	Path
PUT	`/api/v1/delivery`

Request Body¶

Field	Type	Required	Description
`default_validity_seconds`	int	Yes	`1` to `315360000` (10 years).
`retry_intervals_seconds`	array	Yes	Each at least 1.

Sample Request¶

{
    "default_validity_seconds": 86400,
    "retry_intervals_seconds": [60, 300]
}

Sample Response¶

{
    "result": {
        "default_validity_seconds": 86400,
        "retry_intervals_seconds": [60, 300]
    }
}