Owners contain details about the eagle.io account associated with a Workspace or Device.

Owner Attributes

Consumers of Owners should tolerate the addition of new attributes and variance in ordering of attributes with ease. Not all attributes appear in all contexts. It is generally safe to consider a nulled attribute, an empty set, and the absence of an attribute as the same thing.

Attribute Type Description
_class String Identifies resource type: io.eagle.models.owner.Owner
_id ObjectId Unique identifier for this owner
accountName String Name of the account
categories Array Array of notification categories configured for this owner
createdTime Time ISO8601 timestamp the account was created.
slug String Used as part of Node full name path

Retrieve owner

Retrieve the owner associated with the API key.


Argument Example Description
attr _id,slug Optional. Comma delimited list of attributes to include in response


GET /api/v1/owners/account


HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
    "_class": "io.eagle.models.owner.Owner",
    "_id": "5424fbe96c4728a166f0d725",
    "accountName": "My Personal Account",
    "createdTime": "2014-01-26T05:38:49.167Z",
    "slug": "mypers42",
    "categories": [
            "name": "Maintenance",
            "index": 0,
            "_id": "52969367593a1a3a32000012"
            "name": "Operations",
            "index": 1,
            "_id": "52969367593a1a3a32000011"
            "name": "Critical",
            "index": 2,
            "_id": "52969367593a1a3a32000010"
PDF HTML Epub Powered by Read The Docs