This API call returns a list of watches for a parent.
- API URL
- https://youraccount.beetil.com/external_api/v1/:parent/:parent_id/watches.format
- HTTP Method
- GET
URL parameters
| Parameter | Format | Default | Mandatory |
|---|---|---|---|
| parentThe name of the parent the watch belongs to (see points of interest). | string | Yes | |
| parent_idThe id of the parent the watch belongs to (see points of interest). | integer | Yes |
Points of Interest
- Watches never exist stand-alone; they always belongs to a parent.
- Known parents: changes, incidents, releases, problems, messages, config items and knowledge articles.
Example uri: /external_api/v1/incidents/123/watches/321
Example uri: /external_api/v1/changes/987/watches
Example JSON Response
{
"result": {
"watches": [
{
"id": 811,
"watched_by": {
"user_link": "/external_api/v1/users/20",
"avatar": {
"public_filename": "/avatars/get/06/e3/06e36438eef1ee3e569bc4af0ae608228a0c368d/image_jpeg/bruce_lee_2_lrg.jpg"
},
"id": 20,
"full_name": "Carl Humphrey",
"last_name": "Humphrey",
"first_name": "Carl"
},
"watch_link": "/external_api/v1/incidents/331/watches/811"
},
{
"id": 812,
"watched_by": {
"user_link": "/external_api/v1/users/18",
"avatar": {
"public_filename": "/avatars/get/67/ca/67ca168dcb91d0e315bdaf440b6137dc76103ca1/image_png/Picture_1.png"
},
"id": 18,
"full_name": "Dan Lee",
"last_name": "Lee",
"first_name": "Dan"
},
"watch_link": "/external_api/v1/incidents/331/watches/812"
}
]
},
"version": "1.0",
"status": "Success"
}Last updated 31 January 2011