Devices · Sailthru Mobile Developer Documentation

This endpoint updates a device with new attributes, merging (not replacing) the attributes you sent in the request with the ones present on the device record. Note that if sent a mix invalid data (keys other than `user_email`, `user_id`, `user_attributes` or `tags`, or invalid values for any of the above) and valid data, we'll take the valid data and discard the invalid. If only invalid data is sent, however, we'll return a 422 response. ## Valid Types [block:parameters] { "data": { "h-0": "Data type", "h-1": "Ranges/valid values", "h-2": "Example", "0-0": "`integer`", "h-3": "Notes", "0-1": "`-2,147,483,647` to `2,147,483,647`", "0-2": "`12`, `24`, `25`", "0-3": "Floating point numbers are accepted but they will be truncated to an `integer`. If you wish to keep the decimal part, use `float` instead.\n\nValues out of range will be discarded.", "1-0": "`float`", "1-2": "`12.343`, `123.33`", "2-0": "`string`", "2-2": "`Cody`, `gold`, `A string with a , comma`", "2-1": "UTF-8 character encoding", "2-3": "Maximum 255 characters long", "3-0": "`date`", "3-1": "ISO 8601, e.g. `YYYY-MM-ddTHH:mm:ssZ`", "3-2": "`2017-02-06T18:25:32+0300`", "4-0": "`boolean`", "4-1": "`true` or `false`", "1-1": "Single-precision 32-bit IEEE 754 floating point.", "1-3": "Floats greater than 32-bit will be converted to scientific notation.", "4-3": "", "h-4": "Can be sent as array", "0-4": "Yes", "1-4": "Yes", "2-4": "Yes", "3-4": "Yes", "4-4": "No" }, "cols": 5, "rows": 5 } [/block] #### User Attributes Hash Structure User Attributes - sometimes called Custom Attributes - have a specific structure that must be user when setting them via the Sailthru Mobile API. Below is an annotated example: [block:code] { "codes": [ { "code": "{\n \"device\": {\n \"user_attributes\": { // Hash containing all the attributes we want to set\n \"first_name\": { // The name of the attribute\n \"type\": \"string\", // Attribute type as described above\n \"value\": \"Cody\" // The actual value of the attribute\n },\n \"last_name\": {\n \"type\": \"string\",\n \"value\": \"Buena\"\n }\n // + as many as 48 other attributes you want to set\n }\n }\n}", "language": "javascript", "name": "User Attributes" } ] } [/block] #### Custom Attribute Limits There are limits in place on the maximum number of custom attributes allowed as well as the length (size) of strings and arrays. * A maximum of **50** custom attributes is allowed per device. If you exceed this amount any new attributes being set will be discarded. * String values that have more than **255** characters will be truncated. The limitation is on the character length, not on the size in bytes. * Arrays with more than **50** elements will be truncated. #### Key Name Restrictions There are some restrictions in place on the key name, these are: * **Only letters, numbers, underscore and dash are valid characters.** * Leading spaces will be removed. `" my_string_key "` will become `"my_string_key"`. * Invalid characters other than spaces and dots will be removed. `"my_string_key~~~~"` will become `"my_string_key"`. * Spaces and dots will be replaced for underscores. `"my string.key"` will become `"my_string_key"`. * Keys will be truncated to a maximum of 255 characters. * Invalid keys (including keys exclusively made of invalid characters) will simply be discarded and no error will be returned.

Method	{{ tryResults.method }}
Request Headers	{{ tryResults.requestHeaders }}
URL	{{ tryResults.url }}
Request Data	{{ tryResults.data }}
Status
Response Headers	{{ tryResults.responseHeaders }}

Sailthru Mobile Developer Documentation

Getting started

Install in your app

Message Stream

Messaging your users

Before you submit your app

REST API

Advanced Techniques

putDevices

Definition

Parameters

Path Params

Body Params

Examples

Result Format

Documentation

User Information

Try It Out