Add Assets
post
                    /mobile/system/locationManagement/assets
Creates one or more location assets.
Permissions
Only team members with the Administrator role can access the Location Management API.
Request
Supported Media Types
                - application/json
Root Schema : Asset Items Array
    
      Type: 
      
    
    
    
    objectTitle: 
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
        Show Source
        Asset Items Array- 
            items: 
            array  items
            
            Minimum Number of Items:1Array of the assets to be created.
Nested Schema : items
    
      
      Type: 
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    arrayMinimum Number of Items: 
    
    
    
    
    1Array of the assets to be created.
    
    
    
    
    
        Show Source
        - 
            [0]: 
                object  Create Asset
            
            Title:Create AssetThe asset to be created.
Nested Schema : Create Asset
    
      Type: 
      
    
    
    
    objectTitle: 
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    Create AssetThe asset to be created.
    
    
    
    
        Show Source
        - 
            attributes: 
            object  Attributes
            
            Title:AttributesAdditional Properties Allowed: additionalPropertiesThe attributes entered in the UI, as key/value pairs.
- 
            description: 
            string
            Asset's description.
- 
            devices: 
            array  devices
            
            Minimum Number of Items:0IDs of devices that are associated with this asset. Typically one device ID, but there can be multiple associated devices.
- 
            label: 
            string
            Asset's label.
- 
            lastKnownLocation: 
            object  Last Known Location
            
            Title:Last Known LocationLast known location of the asset.
- 
            name: 
            string
            User-defined name for the asset. Must be unique.
Nested Schema : Attributes
    
      Type: 
      
    
    
    
    objectTitle: 
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
       AttributesAdditional Properties Allowed
       Show Source
       
       
    
    
    
    
    
    
    The attributes entered in the UI, as key/value pairs.
    
    
    
    
        Show Source
        Nested Schema : devices
    
      
      Type: 
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    arrayMinimum Number of Items: 
    
    
    
    
    0IDs of devices that are associated with this asset. Typically one device ID, but there can be multiple associated devices.
    
    
    
    
    
        Show Source
        
        
    
    
    
    
    
    
Nested Schema : Last Known Location
    
      Type: 
      
    
    
    
    objectTitle: 
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    Last Known LocationLast known location of the asset.
    
    
    
    
    
    
    
    
    Match One
    Show Source
    
    
    
    
    
Nested Schema : gpsPoint
    
      Type: 
      
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    objectGPS point.
    
    
    
    
        Show Source
        - 
            latitude: 
            number
            GPS point's latitude
- 
            longitude: 
            number
            GPS point's longitude.
Example Request (application/json)
                {
    "items":[
        {
            "devices":[
                1111
            ],
            "lastKnownLocation":{
                "placeId":244
            },
            "name":"hospital bed #233",
            "description":"model 1225 hospital bed",
            "attributes":{
                "SJId":"6754843090",
                "EquipmentManufacturer":"Example Company"
            },
            "label":"hospital bed"
        }
    ]
}Response
Supported Media Types
                - application/json
200 Response
The location assets were created successfully.
                
                
                    Root Schema : Asset Items Array
    
      Type: 
      
    
    
    
    objectTitle: 
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
        Show Source
        Asset Items Array- 
            items: 
            array  items
            
            Minimum Number of Items:1Array of the created assets.
Nested Schema : items
    
      
      Type: 
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    arrayMinimum Number of Items: 
    
    
    
    
    1Array of the created assets.
    
    
    
    
    
        Show Source
        - 
            [0]: 
                object  Asset
            
            Title:AssetThe created or updated asset.
Nested Schema : Asset
    
      Type: 
      
    
    
    
    objectTitle: 
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    AssetThe created or updated asset.
    
    
    
    
        Show Source
        - 
            attributes: 
            object  Attributes
            
            Title:AttributesAdditional Properties Allowed: additionalPropertiesThe attributes entered in the UI, as key/value pairs.
- 
            createdBy: 
            string
            User who added the asset.
- 
            createdOn: 
            string
            When the asset was added.
- 
            description: 
            string
            Asset's description.
- 
            devices: 
            array  devices
            
            Minimum Number of Items:0The devices that are associated with this asset. Typically one device, but there can be multiple associated devices.
- 
            id: 
            number
            Asset's ID.
- 
            label: 
            string
            Asset's label.
- 
            lastKnownLocation: 
            object  Last Known Location
            
            Title:Last Known LocationLast known location of the asset.
- 
            links: 
            array  Relationship links
            
            Title:Relationship linksMinimum Number of Items:1Unique Items Required:true
- 
            modifiedBy: 
            string
            User who last modified the asset.
- 
            modifiedOn: 
            string
            When the asset was last modified.
- 
            name: 
            string
            User-defined name for the asset.
Nested Schema : Attributes
    
      Type: 
      
    
    
    
    objectTitle: 
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
       AttributesAdditional Properties Allowed
       Show Source
       
       
    
    
    
    
    
    
    The attributes entered in the UI, as key/value pairs.
    
    
    
    
        Show Source
        Nested Schema : devices
    
      
      Type: 
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    arrayMinimum Number of Items: 
    
    
    
    
    0The devices that are associated with this asset. Typically one device, but there can be multiple associated devices.
    
    
    
    
    
        Show Source
        - 
            [0]: 
                object  Associated Location Device
            
            Title:Associated Location DeviceThe properties for an associated location device. Note that this object doesn't contain the `asset` and `place` properties.
Nested Schema : Last Known Location
    
      Type: 
      
    
    
    
    objectTitle: 
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    Last Known LocationLast known location of the asset.
    
    
    
    
    
    
    
    
    Match One
    Show Source
    
    
    
    
    
Nested Schema : Relationship links
    
      
      Type: 
    
    
    
    arrayTitle: 
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    Relationship linksMinimum Number of Items: 
    
    
    
    1Unique Items Required: 
    
    
    
    
    
    
        Show Source
        true- 
            [0]: 
                object  Link
            
            Title:Link
Nested Schema : Associated Location Device
    
      Type: 
      
    
    
    
    objectTitle: 
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    Associated Location DeviceThe properties for an associated location device. Note that this object doesn't contain the `asset` and `place` properties.
    
    
    
    
        Show Source
        - 
            attributes: 
            object  Attributes
            
            Title:AttributesAdditional Properties Allowed: additionalPropertiesThe attributes entered in the UI, as key/value pairs.
- 
            beacon: 
            object  Beacon
            
            Title:BeaconDevice's identifying information.
- 
            createdBy: 
            string
            User who added the device.
- 
            createdOn: 
            string
            When the device was added.
- 
            description: 
            string
            Device's description.
- 
            id: 
            number
            Device's ID.
- 
            links: 
            array  Relationship links
            
            Title:Relationship linksMinimum Number of Items:1Unique Items Required:true
- 
            modifiedBy: 
            string
            User who last modified the device.
- 
            modifiedOn: 
            string
            When the device was last modified.
- 
            name: 
            string
            User-defined name for the device.
Nested Schema : Beacon
    
      Type: 
      
    
    
    
    objectTitle: 
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    BeaconDevice's identifying information.
    
    
    
    
    
    
    
    
    Match One
    Show Source
    
    
    
    
    
Nested Schema : iBeacon
    
      Type: 
      
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    objectiBeacon device.
    
    
    
    
        Show Source
        - 
            major: 
            string
            Device's major version number.
- 
            minor: 
            string
            Device's minor version number.
- 
            uuid: 
            string
            Device's UUID.
Nested Schema : altBeacon
    
      Type: 
      
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    objectAltBeacon device.
    
    
    
    
        Show Source
        - 
            id1: 
            string
            Device's first ID.
- 
            id2: 
            string
            Device's second ID.
- 
            id3: 
            string
            Device's third ID.
Nested Schema : eddystone
    
      Type: 
      
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    objectEddystone device.
    
    
    
    
        Show Source
        - 
            eddystoneUid: 
            object  eddystoneUid
            
            Device's UID.
- 
            eddystoneUrl: 
            object  eddystoneUrl
            
            Device's URL.
Nested Schema : eddystoneUid
    
      Type: 
      
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    objectDevice's UID.
    
    
    
    
        Show Source
        - 
            instance: 
            string
            Individual device's ID.
- 
            namespace: 
            string
            Namespace that the device is a member of.
Nested Schema : gpsPoint
    
      Type: 
      
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    objectGPS point.
    
    
    
    
        Show Source
        - 
            latitude: 
            number
            GPS point's latitude
- 
            longitude: 
            number
            GPS point's longitude.
Nested Schema : Link
    
      Type: 
      
    
    
    
    objectTitle: 
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
        Show Source
        Link- 
            href: 
            string
            A relative URL.
- 
            rel: 
            
            Allowed Values:[ "self", "canonical", "prev", "next" ]The type of link.
Example Response (application/json)
                    {
    "items":[
        {
            "modifiedOn":"2015-08-06T18:37:59.424Z",
            "devices":[
                {
                    "modifiedOn":"2015-08-08T07:22:44.654Z",
                    "beacon":{
                        "iBeacon":{
                            "major":"1.0",
                            "minor":"1.1",
                            "uuid":"B9407F30-F5F8-466E-AFF9-25556B57FE6D"
                        }
                    },
                    "createdBy":"jdoe",
                    "name":"RC_WH_01_F01_B001",
                    "description":"Beacon on 1st Floor in FixitFast Warehouse in Redwood City",
                    "modifiedBy":"tsmith",
                    "links":[
                        {
                            "rel":"canonical",
                            "href":"/mobile/platform/location/devices/3401"
                        },
                        {
                            "rel":"self",
                            "href":"/mobile/platform/location/devices/3401"
                        }
                    ],
                    "attributes":{
                        "visibility":"Public",
                        "manufacturerId":"10D39AE7-020E-4467-9CB2-DD36366F899D",
                        "manufacturer":"Abc Company",
                        "status":"Active"
                    },
                    "id":3401,
                    "createdOn":"2015-08-06T18:37:59.424Z"
                }
            ],
            "createdBy":"jdoe",
            "lastKnownLocation":{
                "placeId":244
            },
            "name":"hospital bed #233",
            "description":"model 1225 hospital bed",
            "modifiedBy":"jdoe",
            "links":[
                {
                    "rel":"canonical",
                    "href":"/mobile/platform/location/assets/333"
                },
                {
                    "rel":"self",
                    "href":"/mobile/platform/location/assets/333"
                }
            ],
            "attributes":{
                "SJId":"6754843090",
                "EquipmentManufacturer":"Example Company"
            },
            "label":"hospital bed",
            "id":333,
            "createdOn":"2015-08-06T18:37:59.424Z"
        }
    ]
}400 Response
Bad request.
Root Schema : Error
    
      Type: 
      
    
    
    
    objectTitle: 
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    ErrorThe error JSON object returned by the service.
    
    
    
    
        Show Source
        - 
            detail: 
            string
            Message that provides the error details.
- 
            o:ecid: 
            string
            Execution context ID, which is a unique identifier to correlate events or requests that are associated with the same transaction across several components.
- 
            o:errorCode: 
            string
            The service's error code.
- 
            o:errorDetails: 
            array  o:errorDetails
            
            Minimum Number of Items:0List of the issues that cause the error. Included when the error is caused by multiple issues.
- 
            o:errorPath: 
            string
            The relative point in the API path where the error occurred.
- 
            status: 
            integer
            HTTP status code. See http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html for more details.
- 
            title: 
            string
            Summary of the problem.
- 
            type: 
            string
            The URI to the link that provides details about the HTTP status code.
Nested Schema : o:errorDetails
    
      
      Type: 
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    arrayMinimum Number of Items: 
    
    
    
    
    0List of the issues that cause the error. Included when the error is caused by multiple issues.
    
    
    
    
    
        Show Source
        - 
            [0]: 
                object  Error Detail
            
            Title:Error Detail
Nested Schema : Error Detail
    
      Type: 
      
    
    
    
    objectTitle: 
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
        Show Source
        Error Detail- 
            instance: 
            string
            The URI to the link that provides more detailed information about the error.
- 
            o:errorCode: 
            string
            The service's error code.
- 
            o:errorPath: 
            string
            The relative point in the API path where the error occurred.
- 
            title: 
            string
            Summary of the problem.
- 
            type: 
            string
            The URI to the link that provides details about the HTTP status code.
Examples
The following example shows how to create assets by submitting a POST request on the REST resource using cURL. For more information about cURL, see Use cURL.
curl -i -X POST -u administrator@example.com:password -d @assets.json -H "Content-Type: application/json; charset=utf-8" -H "Oracle-Mobile-Backend-ID: ABCD9278-091f-41aa-9cb2-184bd0586fce" http://fif.cloud.oracle.com/mobile/system/locationManagement/assets
Examples of Request Body
The following shows an example of the request body.
{
  "items": [
        {
            "name": "fl6",
            "label": "Forklift #6",
            "description": "KM forklift",
            "lastKnownLocation" : null,
            "properties" : {
                "serial number": "OU812-9845873",
                "capacity": "3000lbs"
            }
        },
        {
            "name": "gen233",
            "label": "Generator #233",
            "description": "Portable inverter generator",
            "lastKnownLocation" : null,
            "properties" : {
                "serial number": "6754843090",
                "watts":"1600"
            }
        },
        {
            "name": "exc15",
            "label": "Excavator #15",
            "description": "Hydraulic excavator",
            "lastKnownLocation" : null,
            "properties" : {
                "serial number": "13A3168G",
                "cylinders":"4"
            }
        },
        {
            "name": "wd23",
            "label": "Waste dumpster #23",
            "description": "DR 40 yd dumpster",
            "lastKnownLocation" : null,
            "properties" : {
                "serial number": "mx58sk",
                "capacity": "40 yd",
                "height": "3.5 ft"
            }
        }
    ]
}
 Example of Response Header
The following shows an example of the response header:
200 OK Content-Length: 1733 Content-Type: application/json Date: Tue, 19 Sep 2017 21:48:18 GMT
Example of Response Body
The following example shows the contents of the response body in JSON format:
{
  "items": [
    {
      "id": 30,
      "createdOn": "2017-09-19T21:48:21.145Z",
      "createdBy": "administrator",
      "modifiedOn": "2017-09-19T21:48:21.145Z",
      "modifiedBy": "administrator",
      "name": "fl6",
      "label": "Forklift #6",
      "description": "KM forklift",
      "lastKnownLocation": null,
      "attributes": {
        "capacity": "3000lbs",
        "serial number": "OU812-9845873"
      },
      "links": [
        {
          "rel": "canonical",
          "href": "/mobile/platform/location/assets/30"
        },
        {
          "rel": "self",
          "href": "/mobile/platform/location/assets/30"
        }
      ]
    },
    {
      "id": 31,
      "createdOn": "2017-09-19T21:48:21.168Z",
      "createdBy": "administrator",
      "modifiedOn": "2017-09-19T21:48:21.168Z",
      "modifiedBy": "administrator",
      "name": "gen233",
      "label": "Generator #233",
      "description": "Portable inverter generator",
      "lastKnownLocation": null,
      "attributes": {
        "serial number": "6754843090",
        "watts": "1600"
      },
      "links": [
        {
          "rel": "canonical",
          "href": "/mobile/platform/location/assets/31"
        },
        {
          "rel": "self",
          "href": "/mobile/platform/location/assets/31"
        }
      ]
    },
    {
      "id": 32,
      "createdOn": "2017-09-19T21:48:21.173Z",
      "createdBy": "administrator",
      "modifiedOn": "2017-09-19T21:48:21.173Z",
      "modifiedBy": "administrator",
      "name": "exc15",
      "label": "Excavator #15",
      "description": "Hydraulic excavator",
      "lastKnownLocation": null,
      "attributes": {
        "cylinders": "4",
        "serial number": "13A3168G"
      },
      "links": [
        {
          "rel": "canonical",
          "href": "/mobile/platform/location/assets/32"
        },
        {
          "rel": "self",
          "href": "/mobile/platform/location/assets/32"
        }
      ]
    },
    {
      "id": 33,
      "createdOn": "2017-09-19T21:48:21.177Z",
      "createdBy": "administrator",
      "modifiedOn": "2017-09-19T21:48:21.177Z",
      "modifiedBy": "administrator",
      "name": "wd23",
      "label": "Waste dumpster #23",
      "description": "DR 40 yd dumpster",
      "lastKnownLocation": null,
      "attributes": {
        "capacity": "40 yd",
        "height": "3.5 ft",
        "serial number": "mx58sk"
      },
      "links": [
        {
          "rel": "canonical",
          "href": "/mobile/platform/location/assets/33"
        },
        {
          "rel": "self",
          "href": "/mobile/platform/location/assets/33"
        }
      ]
    }
  ]
}