Create or Update location assigned to given asset

PUT {{baseUrl}}/assets/:id/location?includeShared=false

  • If the given asset has own location, this endpoint will update that location. * If the given asset has no location, this endpoint will create a new location and update the given asset. * If the given asset has inherited location, this endpoint will create a new location and update the given asset. If you wanted to update the inherited location you have to use the 'location' url in AssetResource object (with PUT method).

Request Params

KeyDatatypeRequiredDescription
includeSharedbooleanSpecifies if the operation should take into account shared (received) assets, aspects and asset types. Received resources are not visible in case includeShared=false. For query operations, received resources are not returned. Endpoints addressing individual resources respond with 404. In case received resources are referenced in a request parameter or property, they are treated as not existing.

Request Body

{"country"=>"<string>", "region"=>"<string>", "locality"=>"<string>", "streetAddress"=>"<string>", "postalCode"=>"<string>", "longitude"=>"<number>", "latitude"=>"<number>"}

HEADERS

KeyDatatypeRequiredDescription
If-Matchstring(Required) Last known version to facilitate optimistic locking
Content-Typestring
Acceptstring

RESPONSES

status: OK

{&quot;typeId&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},&quot;parentId&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},&quot;timezone&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},&quot;twinType&quot;:&quot;performance&quot;,&quot;tenantId&quot;:&quot;mdsp&quot;,&quot;subTenant&quot;:&quot;UnkarPlutt Inc.&quot;,&quot;t2Tenant&quot;:&quot;DEPRECATED: use subTenant instead&quot;,&quot;assetId&quot;:&quot;c27a28b6eb16b507fabc11e75da8b4ce&quot;,&quot;fileAssignments&quot;:[{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;}],&quot;locks&quot;:[{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;}],&quot;deleted&quot;:&quot;1992-05-06T17:57:11.041Z&quot;,&quot;sharing&quot;:{&quot;modes&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;}},&quot;etag&quot;:1,&quot;_links&quot;:{&quot;self&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},&quot;parent&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},&quot;children&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},&quot;variables&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},&quot;aspects&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},&quot;t2Tenant&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},&quot;location&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;}},&quot;hierarchyPath&quot;:[{&quot;assetId&quot;:&quot;c27a28b6eb16b507fabc11e75da8b4ce&quot;,&quot;name&quot;:&quot;Millenium Falcon&#39;s parent&quot;},{&quot;assetId&quot;:&quot;c27a28b6eb16b507fabc11e75da8b4ce&quot;,&quot;name&quot;:&quot;Millenium Falcon&#39;s parent&quot;}]}