{"__v":4,"_id":"57f1a9150e09dc0e002cce35","category":{"__v":20,"_id":"55e67b5dde6fef23009480ca","pages":["55ed06c7023a81170018f163","55ed079b0d968e2100de8339","55ed0b530d968e2100de8345","55ed0bb078319821005005cf","55ed0df94fba582b0036a18a","55ed0e0c4fba582b0036a18d","55ed0ebd8da0b12100e64246","55ed10bec9d5b3350072ae9a","55ed11410d968e2100de834d","55ed118678319821005005d9","55ed121dc9d5b3350072ae9e","55ed12de8da0b12100e6424e","55ed13930d968e2100de8352","55ed140c4fba582b0036a196","55ed1902c9d5b3350072aebb","55ed197bc9d5b3350072aec0","55ee3dba1452cd0d009e5ee9","5600a22f0c703d19009531e1","5600c6b23aa0520d00da0c41","561da674e078f40d00eadd75"],"project":"55e67aaa9cc7c62b00c4a1ea","version":"55e67aab9cc7c62b00c4a1ed","sync":{"url":"","isSync":false},"reference":true,"createdAt":"2015-09-02T04:30:21.948Z","from_sync":false,"order":5,"slug":"rest-api","title":"REST API"},"parentDoc":null,"project":"55e67aaa9cc7c62b00c4a1ea","user":"57e9c9dc80c0490e00480948","version":{"__v":10,"_id":"55e67aab9cc7c62b00c4a1ed","project":"55e67aaa9cc7c62b00c4a1ea","createdAt":"2015-09-02T04:27:23.612Z","releaseDate":"2015-09-02T04:27:23.612Z","categories":["55e67aac9cc7c62b00c4a1ee","55e67b5556007d23005fee7d","55e67b5dde6fef23009480ca","55e680efde6fef23009480db","55e6829485a9741900314e99","561c61b4ad272c0d00a892df","586c014c0abf1d0f000d04d4","58991d2ad207df0f0002186b","589b8e1fdbb7cd190026732c","58b8ca5e3265d70f001788d4"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"1.0.0","version":"1.0"},"updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-10-03T00:40:53.581Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"examples":{"codes":[{"code":"# Basic Event\ncurl -X POST -u :API_KEY -d '{\"events\":[{\"name\":\"event_name\", \"date\":\"2016-09-11T18:04:23Z\"}]}' -H \"Content-Type:application/json\" -H 'Accept: application/json' https://api.carnivalmobile.com/v4/devices/:device_id/events\n\n# Basic Events (multiple)\ncurl -X POST -u :API_KEY -d '{\"events\":[{\"name\":\"event_name\", \"date\":\"2016-09-11T18:04:23Z\"},{\"name\":\"event_name_2\", \"date\":\"2016-09-11T19:04:23Z\"}]}' -H \"Content-Type:application/json\" -H 'Accept: application/json' https://api.carnivalmobile.com/v4/devices/:device_id/events\n\n# Basic Event (without date)\ncurl -X POST -u :API_KEY -d '{\"events\":[{\"name\":\"event_name\"}]}' -H \"Content-Type:application/json\" -H 'Accept: application/json' https://api.carnivalmobile.com/v4/devices/:device_id/events\n","language":"curl"}]},"method":"post","results":{"codes":[{"status":202,"language":"json","code":"// your events have been successfully registered\n{}","name":""},{"status":400,"language":"json","code":"//your event data is not in the correct format\n//common issues include: no event name, invalid event object, no events\n{}","name":""},{"status":401,"language":"json","code":"// This error is given when your API client credentials are not correct. \n{\n  \"error\":\"unauthorized\"\n}"}]},"settings":"","auth":"required","params":[{"_id":"57f1cfb31d89490e003b28a4","ref":"","in":"path","required":false,"desc":"A Carnival Device ID","default":"","type":"string","name":"device_id"},{"_id":"57f1cfb31d89490e003b28a3","ref":"","in":"body","required":false,"desc":"JSON object containing array of events","default":"","type":"object","name":"events"}],"url":"/devices/:device_id/events"},"isReference":true,"order":6,"body":"**Note 1:** the date property on an event is optional and if left off UTC time will be used in its place.\n\nDates should be formatted using an [ISO 6801](https://en.wikipedia.org/wiki/ISO_860) formatted string.\n\n**Note 2:** In versions prior to v5, the `/devices/events` endpoint would prepend `Public Api:` to events when viewed in the web view. In v5, this behavior has been removed, but if your code depends on this, then you can use the `/v4/devices/events/` endpoint.","excerpt":"Add events for a specific device","slug":"devices-events","type":"endpoint","title":"Devices / Events"}

postDevices / Events

Add events for a specific device

Definition

{{ api_url }}{{ page_api_url }}

Parameters

Path Params

device_id:
string
A Carnival Device ID

Body Params

events:
object
JSON object containing array of events

Examples


Result Format


Documentation

**Note 1:** the date property on an event is optional and if left off UTC time will be used in its place. Dates should be formatted using an [ISO 6801](https://en.wikipedia.org/wiki/ISO_860) formatted string. **Note 2:** In versions prior to v5, the `/devices/events` endpoint would prepend `Public Api:` to events when viewed in the web view. In v5, this behavior has been removed, but if your code depends on this, then you can use the `/v4/devices/events/` endpoint.

User Information

Try It Out

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