Bulk changes to entities

Use this request to quickly update multiple entities at once: goals, projects, or project portfolios.

https://api.tracker.yandex.net/v3/entities/<entity_type>/bulkchange/_update

Query format

Before making a request, get permission to access the API.

Use an HTTP POST request for bulk changes of multiple entities. In the request body, specify the parameters in JSON format.

POST /v3/entities/<entity_type>/bulkchange/_update
Host: api.tracker.yandex.net
Authorization: OAuth <OAuth_token>
X-Org-ID or X-Cloud-Org-ID: <organization_ID>

{
   "metaEntities":[ "<entity_1_ID>","<entity_2_ID>", ...],
   "values":
   {
      "fields":
      {
         "<field_key>":"<value>",
         ...
      },
      "comment":"<comment>"
   }
}

Example: Updating a status, assigning a follower, leaving a comment for multiple projects

• An HTTP POST method is used.
• The project status changes to At risk.
• A follower is assigned.
• A new record is added to project comments.

POST /v3/entities/project/bulkchange/_update HTTP/1.1
Host: api.tracker.yandex.net
Authorization: OAuth <OAuth_token>
X-Org-ID or X-Cloud-Org-ID: <organization_ID>

{
   "metaEntities":[ "655f3be523db2132********","655f383923db2132********"],
   "values":
   {
      "fields":
      {
         "entityStatus":"at_risk",
         "followers":"agent007",
      },
      "comment":"The project is at risk"
   }
}

Response format

{
   "id": "6560c6f59b0b1e76********",
   "self": "https://api.tracker.yandex.net/v3/bulkchange/6560c6f59b0b1e76********",
   "createdBy": { "self": "https://api.tracker.yandex.net/v3/users/11********", "id": "11********", "display": "Full name", "cloudUid": "ajevuhegoggf********", "passportUid": 11******** },
   "createdAt": "2023-11-24T15:53:25.122+0000",
   "status": "CREATED",
   "statusText": "Bulk change task created.",
   "executionChunkPercent": 0,
   "executionIssuePercent": 0
}