Gamma API

Get model element properties

POST
/api/projects/{projectId}/models/metadata/objects

Elements by GlobalId, each with all its properties, read at the version asked for or else at the model's newest converted one. Elements not found are left out; a version asked for with no conversion is listed in notConvertedVersions, and a model with none in notConverted. 409 when the organization's storage the files are in is disconnected.

Who may call it: Anyone on the project whose permission profile allows model.read. API keys: yes, given model.read for this project.

Authorization

cookiegamma.session_token<token>

The session cookie a sign-in sets. Over HTTPS its name carries the __Secure- prefix. Browsers send it on their own; other clients keep it from the sign-in response.

Path Parameters

projectId*string

The project's id.

Request Body

application/json
  1. body
objects*array<>
Items1 <= items <= 5000

Response Body

OK.

application/json
  1. response
objects*array<>

The elements found; those not found are left out.

notConverted*array<string>

Models asked for without a version that have no converted version.

notConvertedVersions*array<>

Versions asked for that have no conversion; not read at another version.

Example Request
curl -X POST 'http://localhost:3000/api/projects/string/models/metadata/objects' \  -H 'Content-Type: application/json' \  -d '{  "objects": [    {      "modelId": "string",      "objectId": "string"    }  ]}'
Example Response
{  "objects": [    {      "modelId": "string",      "versionId": "string",      "version": -9007199254740991,      "object": {        "objectId": "string",        "modelObjectId": -9007199254740991,        "name": "string",        "category": "string",        "storeyId": -9007199254740991,        "storey": "string",        "relevantStoreyIds": "string",        "phaseCreated": "string",        "phaseDemolished": "string",        "material": "string",        "originalId": "string",        "originalCategory": "string",        "originalStorey": "string",        "apsId": "string",        "revitId": "string",        "centerX": 0,        "centerY": 0,        "centerZ": 0      },      "properties": [        {          "category": "string",          "name": "string",          "unit": "string",          "value": "string"        }      ]    }  ],  "notConverted": [    "string"  ],  "notConvertedVersions": [    {      "modelId": "string",      "version": -9007199254740991    }  ]}