Gamma API
ProgressObjects

Get a tracked object

GET
/api/projects/{projectId}/objects/{id}

Trash included. Refused with 409 when a model's files are on storage that is no longer connected.

Who may call it: Anyone on the project whose permission profile allows object.read. API keys: yes, given object.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.

id*string

Response Body

OK.

application/json
  1. response
object*

A model element someone has set a status on, by its GlobalId — the same element across every model and version.

models*array<>

The element as each model it is on or was statused on reads it, at the model's newest conversion; the model it is on first.

notConverted*array<string>

Those models' ids that have no converted version to read.

Example Request
curl -X GET 'http://localhost:3000/api/projects/string/objects/string'
Example Response
{  "object": {    "id": "string",    "objectId": "string",    "name": "string",    "category": "string",    "modelId": "string",    "modelVersionId": "string",    "createdAt": "2019-08-24T14:15:22Z",    "updatedAt": "2019-08-24T14:15:22Z",    "deletedAt": "2019-08-24T14:15:22Z",    "deletedById": "string",    "deleteReason": "string",    "statuses": [      {        "categoryId": "string",        "valueId": "string",        "modelId": "string",        "modelVersionId": "string",        "viewpoint": null,        "updatedById": "string",        "updatedAt": "2019-08-24T14:15:22Z"      }    ]  },  "models": [    {      "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"  ]}