---
title: "PATCH /projects/{projectId}/iterations/{iterationId}"
method: PATCH
path: "/projects/{projectId}/iterations/{iterationId}"
---

# PATCH /projects/{projectId}/iterations/{iterationId}

`PATCH /projects/{projectId}/iterations/{iterationId}`

Update a specific iteration.

## Path parameters

- `projectId` string, uuid, required
- `iterationId` string, uuid, required

## Request body

- Iteration — Iteration model to be sent over JSON.
  - `id` string, uuid — Gets the id of the iteration.
  - `name` string, required — Gets or sets the name of the iteration.
  - `status` string — Gets the current iteration status.
  - `created` string, date-time — Gets the time this iteration was completed.
  - `lastModified` string, date-time — Gets the time this iteration was last modified.
  - `trainedAt` string, date-time, nullable — Gets the time this iteration was last modified.
  - `projectId` string, uuid — Gets the project id of the iteration.
  - `exportable` boolean — Whether the iteration can be exported to another format for download.
  - `exportableTo` string[] — A set of platforms this iteration can export to.
  - `domainId` string, uuid, nullable — Get or sets a guid of the domain the iteration has been trained on.
  - `classificationType` 'Multiclass' | 'Multilabel', nullable — Gets the classification type of the project.
  - `trainingType` 'Regular' | 'Advanced' — Gets the training type of the iteration.
  - `reservedBudgetInHours` integer — Gets the reserved advanced training budget for the iteration.
  - `trainingTimeInMinutes` integer — Gets the training time for the iteration.
  - `publishName` string — Name of the published model.
  - `originalPublishResourceId` string — Resource Provider Id this iteration was originally published to.

## Response `200`

OK

- Iteration — Iteration model to be sent over JSON.
  - `id` string, uuid — Gets the id of the iteration.
  - `name` string, required — Gets or sets the name of the iteration.
  - `status` string — Gets the current iteration status.
  - `created` string, date-time — Gets the time this iteration was completed.
  - `lastModified` string, date-time — Gets the time this iteration was last modified.
  - `trainedAt` string, date-time, nullable — Gets the time this iteration was last modified.
  - `projectId` string, uuid — Gets the project id of the iteration.
  - `exportable` boolean — Whether the iteration can be exported to another format for download.
  - `exportableTo` string[] — A set of platforms this iteration can export to.
  - `domainId` string, uuid, nullable — Get or sets a guid of the domain the iteration has been trained on.
  - `classificationType` 'Multiclass' | 'Multilabel', nullable — Gets the classification type of the project.
  - `trainingType` 'Regular' | 'Advanced' — Gets the training type of the iteration.
  - `reservedBudgetInHours` integer — Gets the reserved advanced training budget for the iteration.
  - `trainingTimeInMinutes` integer — Gets the training time for the iteration.
  - `publishName` string — Name of the published model.
  - `originalPublishResourceId` string — Resource Provider Id this iteration was originally published to.

## Other responses

- `default` — Error response

## Changes

- **2026-07-13** `e873dad2a189` — 1 warning, 2 info
  - deleted the `header` request parameter `Training-Key`
  - api operation id `UpdateIteration` removed and replaced with `Iterations_Update`
  - api tag `ProjectApi` removed
- **2026-07-13** `82dfb72c78fa` — 2 info
  - api operation id `Iterations_Update` removed and replaced with `UpdateIteration`
  - api tag `ProjectApi` added
- **2018-02-03** `8feb7cde15fc` — 1 breaking
  - added the new required `header` request parameter `Training-Key`

[Change history](https://skmtc.dev/azure/apis/cognitiveservices-customvision-training/changes/projects/:projectId/iterations/:iterationId/patch.md)

---

[API](https://skmtc.dev/azure/apis/cognitiveservices-customvision-training.md) · [All operations](https://skmtc.dev/azure/apis/cognitiveservices-customvision-training/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/azure/cognitiveservices-customvision-training/revisions/e873dad2a189/schema)