Gamma API
ProgressObjects

Set object statuses

PATCH
/api/projects/{projectId}/objects

One update or up to 500, all or nothing. With object.update-own and not object.update, only elements of scopes the caller created: their models, and a search set's matches on them; 403 otherwise. An element not tracked yet is tracked by it, and moves to the model of its last update. Refused with 409 while an element is in the trash, and with 422 for a category, value, model or version that is not the project's — or an untracked element without modelId.

Who may call it: Anyone on the project whose permission profile allows object.update — or object.update-own, on their own (scopes they created, and the statuses of those scopes' elements). API keys: yes, given object.update 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
updates*array<>

Applied in order; a later update to the same element wins.

Items1 <= items <= 500

Response Body

OK.

application/json
  1. response
objects*array<>
Example Request
curl -X PATCH 'http://localhost:3000/api/projects/string/objects' \  -H 'Content-Type: application/json' \  -d '{  "updates": [    {      "objectId": "string",      "categoryId": "string",      "valueId": "string"    }  ]}'
Example Response
{  "objects": [    {      "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"        }      ]    }  ]}