Post Entities (Asynchronously)

This endpoint is used to create and update entities to ER API in asynchronous fashion. List of entities are provided in the body of the POST request and partition key – ercollectionid should be provided as part of header. As a response application user will get url to track the status of the request along with tracking id.

Note

Once entities created when update entities(full object update), it restricts some below properties to change.
entityType,brickEntityName, brickEntitySubType, brickEntityType.

URL

https://{{HOST}}/apollo/er/entities?v={version}

Method

Required IMS Scopes

• apollo_write

Versions Supported

1.0 (Default)
1.1

URL Query Parameters

Request Header Parameters

Example

Request

curl -X POST 
  'https://{{HOST}}/apollo/er/entities?v=1.1' 
  -H 'Authorization: Bearer ACCESS_TOKEN' 
  -H 'Content-Type: application/json' 
  -H 'ercollectionid: TestER-DVDocs' 
  -H 'async: true'
  -d '{"entityType": "BRICK_0_4__Building", "entityName": "JCI 507 Michigan Street Milwaukee Building B2", "id": "JCI-507-B2"}'

Response

{
    "status": {
        "message": "Request 794973ad-9486-4b46-bb31-93f0fe8b2e8e is processed and can be tracked by URL https://{{HOST}}/apollo/status/logs?transactionid=9b73820e-47ec-4c05-956f-ed674d4798a7",
        "code": "202"
    },
    "transactionId": "9b73820e-47ec-4c05-956f-ed674d4798a7",
    "data": {}
}

Errors