trash nothing

Create an email alert

PUT

/users/me/alerts

users

Request Example

Shell

JavaScript

Java

Swift

curl --location --request PUT 'https://trashnothing.com/api/v1.2/users/me/alerts' \
--form 'search=""' \
--form 'types=""'

Response Example

200 - Example 1

{
    "alert_id": 7584,
    "last_sent": "2018-02-16T12:58:51",
    "search": "table",
    "send_count": 3,
    "types": [
        "offer"
    ],
    "user_id": 9191
}

Request

Body Params multipart/form-data

string

required

When a post matches this search query, an email alert will be sent. Must have a length >= 2 and < 255 characters.

types

string

required

A comma separated list of the post types that the alert should match against. The available post types are: offer, wanted

Responses

🟢200The new alert.

application/json

Body

A search alert that the user has created so that they can be notified when new posts match the search query specified by the alert.

alert_id

string

optional

last_sent

string <date-time>

optional

The UTC date and time when the alert was last triggered and sent out (may be null).

string

optional

The search phrase that the alert triggers on.

send_count

integer

optional

The number of time the alert has triggered and been send out.

types

array[string]

optional

A list of the post types that the alert is set to match against. The available post types are: offer, wanted

NOTE: Additional post types may be added in the future (eg. events) so clients should take care to support arbitrary types being returned.

user_id

string

optional

🟠400Missing or invalid parameters or maximum number of alerts reached.

Modified at 2022-09-11 18:59:48

List current users' email alerts

Delete an email alert