post/tasks/bulk-updateWrite operation

Update multiple tasks safely

Updates up to 35 tasks in input order. Every item is independently protected by its latest developer revision. The operation is not atomic: successful items remain committed when another item conflicts. Placement, assignment, lifecycle, and ordering changes use their dedicated endpoints.

Required scopes

tasks:write

Request example

curl --request POST \
  --url 'https://api.de.teamgrid.app/v1/tasks/bulk-update' \
  --header 'Authorization: Bearer $TEAMGRID_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
    "items": [
      "TaskBulkUpdateItem"
    ]
  }'

const response = await fetch('https://api.de.teamgrid.app/v1/tasks/bulk-update', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.TEAMGRID_API_TOKEN}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
  "items": [
    "TaskBulkUpdateItem"
  ]
}),
})

const result = await response.json()

type ApiResponse = unknown

const response = await fetch('https://api.de.teamgrid.app/v1/tasks/bulk-update', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.TEAMGRID_API_TOKEN}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
  "items": [
    "TaskBulkUpdateItem"
  ]
}),
})

const result: ApiResponse = await response.json()

teamgrid tasks create \
  --data @payload.json

Example response 2xx

{
  "data": [
    "TaskBulkUpdateResult"
  ],
  "meta": {
    "requestId": "string",
    "summary": {
      "conflicts": 0,
      "failed": 0,
      "requested": 1,
      "updated": 0
    }
  }
}

EndpointGerman region

Interactive request builder

Prepare this request

Build locally · nothing is sent

Region

Credential variable

JSON request bodyValid JSON

Generated cURL

The builder does not execute requests or persist credentials. Replace the environment-variable placeholder only in your terminal or secret-aware runtime.

Request body

application/json

required

array<TaskBulkUpdateItem>

The items associated with this task bulk.

Responses

200Ordered per-item results. Reconcile conflicts by reading the task and retrying only the intended item with its new revision.application/json

Response schemaapplication/json

required

array<TaskBulkUpdateResult>

Response data for the completed request.

required

object

Request metadata, including the request identifier and pagination state when applicable.

400The request is invalid.application/json

Response schemaapplication/json

required

array<ApiError>

The errors associated with this error.

required

ResponseMeta

Request metadata, including the request identifier and pagination state when applicable.

401The bearer credential is missing, invalid, expired, or revoked.application/json

Response schemaapplication/json

required

array<ApiError>

The errors associated with this error.

required

ResponseMeta

Request metadata, including the request identifier and pagination state when applicable.

403The credential has insufficient scope.application/json

Response schemaapplication/json

required

array<ApiError>

The errors associated with this error.

required

ResponseMeta

Request metadata, including the request identifier and pagination state when applicable.

429The credential or source exceeded its rate limit.application/json

Response schemaapplication/json

required

array<ApiError>

The errors associated with this error.

required

ResponseMeta

Request metadata, including the request identifier and pagination state when applicable.

502The cell-local application returned an invalid response.application/json

Response schemaapplication/json

required

array<ApiError>

The errors associated with this error.

required

ResponseMeta

Request metadata, including the request identifier and pagination state when applicable.

503A required cell-local dependency is unavailable.application/json

Response schemaapplication/json

required

array<ApiError>

The errors associated with this error.

required

ResponseMeta

Request metadata, including the request identifier and pagination state when applicable.

Operation IDbulkUpdateTasksOpenAPI JSON ↗

Documentation feedbackWas this page useful?