/api/v1/tag/email/

The /tag/email/ endpoint is used to view, add and remove notification tags on email addresses.

INPUT PARAMETERS
email string	The resource_uri of the email address.
tag string	The resource_uri of the notification tag.

 

Examples

List Tagged Email Addresses (List method, GET)

curl --header "Authorization:ApiKey testuser:256ee09ded99b29036fac4de96acedb7e8af7bf7" https://www.statusdashboard.com/api/v1/tag/email/

{
    "meta": {
    	"limit": 10, 
    	"next": null, 
    	"offset": 0, 
    	"previous": null, 
    	"total_count": 1
    }, 
    "objects": [
        {
            "email": {
                "email": "[e-mail]",
                "resource_uri": "/api/v1/email/1001/"
            },
            "resource_uri": "/api/v1/tag/email/1/",
            "tag": {
                "resource_uri": "/api/v1/tag/notification/2/",
                "tag_name": "Customers",
                "tag_value": "Banking"
            }
        }
    ]
}

Upon success, you'll receive back an HTTP 200 (OK) indicating that the API call succeeded.

Add a Notification Tag to an Email Address (List method, POST)

curl --header "Content-Type: application/json" --header "Authorization:ApiKey testuser:256ee09ded99b29036fac4de96acedb7e8af7bf7" -X POST --data '{"email":"[e-mail]", "tag":"/api/v1/tag/notification/2/"}' https://www.statusdashboard.com/api/v1/tag/email/

{
    "email": {
        "email": "[e-mail]",
        "resource_uri": "/api/v1/email/1001/"
    },
    "resource_uri": "/api/v1/tag/email/1/",
    "tag": {
        "resource_uri": "/api/v1/tag/notification/2/",
        "tag_name": "Customers",
        "tag_value": "Banking"
    }
}

Upon success, you'll receive back an HTTP 201 (created) along with details about the resource you just created.

Delete a Notification Tag from an Email Address (Detail method, DELETE)

curl --header "Authorization:ApiKey testuser:256ee09ded99b29036fac4de96acedb7e8af7bf7" -X DELETE https://www.statusdashboard.com/api/v1/tag/email/1/

Upon success, you'll receive back an HTTP 204 (No Content) indicating that the request was fulfilled but there is no data to display.