{
  "info": {
    "_postman_id": "035d266f-0764-4a75-87f3-048d7a2b25c9",
    "name": "Cumulocity Alarm Alarms External IDs API",
    "description": "Raise, query, acknowledge, clear, and bulk-update alarms with four severity levels (CRITICAL, MAJOR,\nMINOR, WARNING) and four statuses (ACTIVE, ACKNOWLEDGED, CLEARED). Cumulocity auto-deduplicates alarms\nby source + type so repeated raises increment the count rather than creating duplicates.\n",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json",
    "createdAt": "2026-07-28T01:28:07.000Z",
    "updatedAt": "2026-07-28T01:28:08.000Z",
    "lastUpdatedBy": "35240",
    "uid": "35240-035d266f-0764-4a75-87f3-048d7a2b25c9"
  },
  "item": [
    {
      "name": "identity",
      "item": [
        {
          "name": "externalIds",
          "item": [
            {
              "name": "{type}",
              "item": [
                {
                  "name": "{externalId}",
                  "item": [
                    {
                      "name": "Retrieve an External ID",
                      "id": "02eb87e0-a1bd-4ca8-b8ed-38c5877174cb",
                      "protocolProfileBehavior": {
                        "disableBodyPruning": true
                      },
                      "request": {
                        "method": "GET",
                        "header": [
                          {
                            "key": "Accept",
                            "value": "application/vnd.com.nsn.cumulocity.externalId+json"
                          }
                        ],
                        "url": {
                          "raw": "{{baseUrl}}/identity/externalIds/:type/:externalId",
                          "host": [
                            "{{baseUrl}}"
                          ],
                          "path": [
                            "identity",
                            "externalIds",
                            ":type",
                            ":externalId"
                          ],
                          "variable": [
                            {
                              "id": "2163e264-3f8a-4e51-a704-66b643dca4e9",
                              "key": "type",
                              "value": "<string>",
                              "description": "(Required) "
                            },
                            {
                              "id": "4e748d1f-4b5e-4d26-8397-deb00ded5038",
                              "key": "externalId",
                              "value": "<string>",
                              "description": "(Required) "
                            }
                          ]
                        }
                      },
                      "response": [
                        {
                          "id": "1fee66b4-ab16-45b5-912d-7437d7e86bbe",
                          "name": "A single external ID record.",
                          "originalRequest": {
                            "method": "GET",
                            "header": [
                              {
                                "key": "Accept",
                                "value": "application/vnd.com.nsn.cumulocity.externalId+json"
                              },
                              {
                                "description": "Added as a part of security scheme: basic",
                                "key": "Authorization",
                                "value": "Basic <credentials>"
                              }
                            ],
                            "url": {
                              "raw": "{{baseUrl}}/identity/externalIds/:type/:externalId",
                              "host": [
                                "{{baseUrl}}"
                              ],
                              "path": [
                                "identity",
                                "externalIds",
                                ":type",
                                ":externalId"
                              ],
                              "variable": [
                                {
                                  "key": "type"
                                },
                                {
                                  "key": "externalId"
                                }
                              ]
                            }
                          },
                          "status": "OK",
                          "code": 200,
                          "_postman_previewlanguage": "json",
                          "header": [
                            {
                              "key": "Content-Type",
                              "value": "application/vnd.com.nsn.cumulocity.externalId+json"
                            }
                          ],
                          "cookie": [],
                          "responseTime": null,
                          "body": "{\n  \"self\": \"<uri>\",\n  \"externalId\": \"<string>\",\n  \"type\": \"<string>\",\n  \"managedObject\": {\n    \"id\": \"<string>\",\n    \"self\": \"<uri>\"\n  }\n}",
                          "createdAt": "2026-07-28T01:28:08.000Z",
                          "updatedAt": "2026-07-28T01:28:08.000Z",
                          "uid": "35240-1fee66b4-ab16-45b5-912d-7437d7e86bbe"
                        }
                      ],
                      "createdAt": "2026-07-28T01:28:08.000Z",
                      "updatedAt": "2026-07-28T01:28:08.000Z",
                      "uid": "35240-02eb87e0-a1bd-4ca8-b8ed-38c5877174cb"
                    },
                    {
                      "name": "Delete an External ID",
                      "id": "dc637417-6cd0-4042-ba52-1492ed008231",
                      "protocolProfileBehavior": {
                        "disableBodyPruning": true
                      },
                      "request": {
                        "method": "DELETE",
                        "header": [],
                        "url": {
                          "raw": "{{baseUrl}}/identity/externalIds/:type/:externalId",
                          "host": [
                            "{{baseUrl}}"
                          ],
                          "path": [
                            "identity",
                            "externalIds",
                            ":type",
                            ":externalId"
                          ],
                          "variable": [
                            {
                              "id": "9882f81d-28d0-4a3d-b5b2-676010f520a1",
                              "key": "type",
                              "value": "<string>",
                              "description": "(Required) "
                            },
                            {
                              "id": "9207ac17-f43b-4644-9039-c518a0dd4ccc",
                              "key": "externalId",
                              "value": "<string>",
                              "description": "(Required) "
                            }
                          ]
                        }
                      },
                      "response": [
                        {
                          "id": "ff9e2cad-5ac5-464e-bb68-88b9d0641377",
                          "name": "External ID deleted.",
                          "originalRequest": {
                            "method": "DELETE",
                            "header": [
                              {
                                "description": "Added as a part of security scheme: basic",
                                "key": "Authorization",
                                "value": "Basic <credentials>"
                              }
                            ],
                            "url": {
                              "raw": "{{baseUrl}}/identity/externalIds/:type/:externalId",
                              "host": [
                                "{{baseUrl}}"
                              ],
                              "path": [
                                "identity",
                                "externalIds",
                                ":type",
                                ":externalId"
                              ],
                              "variable": [
                                {
                                  "key": "type"
                                },
                                {
                                  "key": "externalId"
                                }
                              ]
                            }
                          },
                          "status": "No Content",
                          "code": 204,
                          "_postman_previewlanguage": "text",
                          "header": [],
                          "cookie": [],
                          "responseTime": null,
                          "body": null,
                          "createdAt": "2026-07-28T01:28:08.000Z",
                          "updatedAt": "2026-07-28T01:28:08.000Z",
                          "uid": "35240-ff9e2cad-5ac5-464e-bb68-88b9d0641377"
                        }
                      ],
                      "createdAt": "2026-07-28T01:28:08.000Z",
                      "updatedAt": "2026-07-28T01:28:08.000Z",
                      "uid": "35240-dc637417-6cd0-4042-ba52-1492ed008231"
                    }
                  ],
                  "id": "be739a90-4645-48b4-8f60-00741b060924",
                  "createdAt": "2026-07-28T01:28:08.000Z",
                  "updatedAt": "2026-07-28T01:28:08.000Z",
                  "uid": "35240-be739a90-4645-48b4-8f60-00741b060924"
                }
              ],
              "id": "ca0c373d-7bce-478b-8d3c-f851caaa93fc",
              "createdAt": "2026-07-28T01:28:08.000Z",
              "updatedAt": "2026-07-28T01:28:08.000Z",
              "uid": "35240-ca0c373d-7bce-478b-8d3c-f851caaa93fc"
            }
          ],
          "id": "85a8177c-7897-42eb-a7b2-a28e9d94aecd",
          "createdAt": "2026-07-28T01:28:08.000Z",
          "updatedAt": "2026-07-28T01:28:08.000Z",
          "uid": "35240-85a8177c-7897-42eb-a7b2-a28e9d94aecd"
        },
        {
          "name": "globalIds",
          "item": [
            {
              "name": "{id}",
              "item": [
                {
                  "name": "externalIds",
                  "item": [
                    {
                      "name": "List External IDs for Global ID",
                      "id": "3d795cf4-7120-49fe-bb48-46e706f5c5c8",
                      "protocolProfileBehavior": {
                        "disableBodyPruning": true
                      },
                      "request": {
                        "method": "GET",
                        "header": [
                          {
                            "key": "Accept",
                            "value": "application/vnd.com.nsn.cumulocity.externalIdCollection+json"
                          }
                        ],
                        "url": {
                          "raw": "{{baseUrl}}/identity/globalIds/:id/externalIds",
                          "host": [
                            "{{baseUrl}}"
                          ],
                          "path": [
                            "identity",
                            "globalIds",
                            ":id",
                            "externalIds"
                          ],
                          "variable": [
                            {
                              "id": "18c0d24b-7f57-4d70-941d-5835d7d43eff",
                              "key": "id",
                              "value": "<string>",
                              "description": "(Required) "
                            }
                          ]
                        }
                      },
                      "response": [
                        {
                          "id": "1906a18d-dcb5-4c56-a053-a83ddfae7ef7",
                          "name": "A collection of external IDs.",
                          "originalRequest": {
                            "method": "GET",
                            "header": [
                              {
                                "key": "Accept",
                                "value": "application/vnd.com.nsn.cumulocity.externalIdCollection+json"
                              },
                              {
                                "description": "Added as a part of security scheme: basic",
                                "key": "Authorization",
                                "value": "Basic <credentials>"
                              }
                            ],
                            "url": {
                              "raw": "{{baseUrl}}/identity/globalIds/:id/externalIds",
                              "host": [
                                "{{baseUrl}}"
                              ],
                              "path": [
                                "identity",
                                "globalIds",
                                ":id",
                                "externalIds"
                              ],
                              "variable": [
                                {
                                  "key": "id"
                                }
                              ]
                            }
                          },
                          "status": "OK",
                          "code": 200,
                          "_postman_previewlanguage": "json",
                          "header": [
                            {
                              "key": "Content-Type",
                              "value": "application/vnd.com.nsn.cumulocity.externalIdCollection+json"
                            }
                          ],
                          "cookie": [],
                          "responseTime": null,
                          "body": "{\n  \"self\": \"<uri>\",\n  \"externalIds\": [\n    {\n      \"self\": \"<uri>\",\n      \"externalId\": \"<string>\",\n      \"type\": \"<string>\",\n      \"managedObject\": {\n        \"id\": \"<string>\",\n        \"self\": \"<uri>\"\n      }\n    },\n    {\n      \"self\": \"<uri>\",\n      \"externalId\": \"<string>\",\n      \"type\": \"<string>\",\n      \"managedObject\": {\n        \"id\": \"<string>\",\n        \"self\": \"<uri>\"\n      }\n    }\n  ]\n}",
                          "createdAt": "2026-07-28T01:28:08.000Z",
                          "updatedAt": "2026-07-28T01:28:08.000Z",
                          "uid": "35240-1906a18d-dcb5-4c56-a053-a83ddfae7ef7"
                        }
                      ],
                      "createdAt": "2026-07-28T01:28:08.000Z",
                      "updatedAt": "2026-07-28T01:28:08.000Z",
                      "uid": "35240-3d795cf4-7120-49fe-bb48-46e706f5c5c8"
                    },
                    {
                      "name": "Create an External ID",
                      "id": "e1ab4aa6-b31a-4bb3-88ee-95dd8ab57db0",
                      "protocolProfileBehavior": {
                        "disableBodyPruning": true
                      },
                      "request": {
                        "method": "POST",
                        "header": [
                          {
                            "key": "Content-Type",
                            "value": "application/vnd.com.nsn.cumulocity.externalId+json"
                          }
                        ],
                        "body": {
                          "mode": "raw",
                          "raw": "{\n  \"self\": \"<uri>\",\n  \"externalId\": \"<string>\",\n  \"type\": \"<string>\",\n  \"managedObject\": {\n    \"id\": \"<string>\",\n    \"self\": \"<uri>\"\n  }\n}",
                          "options": {
                            "raw": {
                              "headerFamily": "json",
                              "language": "json"
                            }
                          }
                        },
                        "url": {
                          "raw": "{{baseUrl}}/identity/globalIds/:id/externalIds",
                          "host": [
                            "{{baseUrl}}"
                          ],
                          "path": [
                            "identity",
                            "globalIds",
                            ":id",
                            "externalIds"
                          ],
                          "variable": [
                            {
                              "id": "08e54d9b-600d-41f8-8566-5792e2309a63",
                              "key": "id",
                              "value": "<string>",
                              "description": "(Required) "
                            }
                          ]
                        }
                      },
                      "response": [
                        {
                          "id": "a206b000-a55b-4b41-b4a4-51e4707961b7",
                          "name": "External ID created.",
                          "originalRequest": {
                            "method": "POST",
                            "header": [
                              {
                                "key": "Content-Type",
                                "value": "application/vnd.com.nsn.cumulocity.externalId+json"
                              },
                              {
                                "description": "Added as a part of security scheme: basic",
                                "key": "Authorization",
                                "value": "Basic <credentials>"
                              }
                            ],
                            "body": {
                              "mode": "raw",
                              "raw": "{\n  \"self\": \"<uri>\",\n  \"externalId\": \"<string>\",\n  \"type\": \"<string>\",\n  \"managedObject\": {\n    \"id\": \"<string>\",\n    \"self\": \"<uri>\"\n  }\n}",
                              "options": {
                                "raw": {
                                  "headerFamily": "json",
                                  "language": "json"
                                }
                              }
                            },
                            "url": {
                              "raw": "{{baseUrl}}/identity/globalIds/:id/externalIds",
                              "host": [
                                "{{baseUrl}}"
                              ],
                              "path": [
                                "identity",
                                "globalIds",
                                ":id",
                                "externalIds"
                              ],
                              "variable": [
                                {
                                  "key": "id"
                                }
                              ]
                            }
                          },
                          "status": "Created",
                          "code": 201,
                          "_postman_previewlanguage": "text",
                          "header": [],
                          "cookie": [],
                          "responseTime": null,
                          "body": null,
                          "createdAt": "2026-07-28T01:28:08.000Z",
                          "updatedAt": "2026-07-28T01:28:08.000Z",
                          "uid": "35240-a206b000-a55b-4b41-b4a4-51e4707961b7"
                        }
                      ],
                      "createdAt": "2026-07-28T01:28:08.000Z",
                      "updatedAt": "2026-07-28T01:28:08.000Z",
                      "uid": "35240-e1ab4aa6-b31a-4bb3-88ee-95dd8ab57db0"
                    }
                  ],
                  "id": "c376d707-f36a-44d8-a4a8-3932765a980a",
                  "createdAt": "2026-07-28T01:28:08.000Z",
                  "updatedAt": "2026-07-28T01:28:08.000Z",
                  "uid": "35240-c376d707-f36a-44d8-a4a8-3932765a980a"
                }
              ],
              "id": "cc431487-359f-4721-8a44-e44b702b251c",
              "createdAt": "2026-07-28T01:28:08.000Z",
              "updatedAt": "2026-07-28T01:28:08.000Z",
              "uid": "35240-cc431487-359f-4721-8a44-e44b702b251c"
            }
          ],
          "id": "315b541d-f56c-48a3-b728-a75e86b7f26d",
          "createdAt": "2026-07-28T01:28:08.000Z",
          "updatedAt": "2026-07-28T01:28:08.000Z",
          "uid": "35240-315b541d-f56c-48a3-b728-a75e86b7f26d"
        }
      ],
      "id": "4461ddf3-1fb8-46c6-a1f7-575e9c46917e",
      "createdAt": "2026-07-28T01:28:08.000Z",
      "updatedAt": "2026-07-28T01:28:08.000Z",
      "uid": "35240-4461ddf3-1fb8-46c6-a1f7-575e9c46917e"
    }
  ],
  "auth": {
    "type": "basic",
    "basic": [
      {
        "key": "username",
        "value": "{{basicAuthUsername}}",
        "type": "string"
      },
      {
        "key": "password",
        "value": "{{basicAuthPassword}}",
        "type": "string"
      }
    ]
  },
  "variable": [
    {
      "key": "tenant",
      "value": "example"
    },
    {
      "key": "baseUrl",
      "value": "https://{{tenant}}.cumulocity.com"
    }
  ]
}