---
title: "Update a specific iteration."
method: PATCH
path: "/projects/{projectId}/iterations/{iterationId}"
tags: ["ProjectApi"]
---

# Update a specific iteration.

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

## 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.
  - `customBaseModelInfo` CustomBaseModelInfo
    - `projectId` string, uuid, required — Project Id of the previously trained project to be used for current iteration's training.
    - `iterationId` string, uuid, required — Iteration Id of the previously trained project to be used for current iteration's training.
  - `trainingErrorDetails` string — Training error details, when training fails. Value is null when training succeeds.

## 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.
  - `customBaseModelInfo` CustomBaseModelInfo
    - `projectId` string, uuid, required — Project Id of the previously trained project to be used for current iteration's training.
    - `iterationId` string, uuid, required — Iteration Id of the previously trained project to be used for current iteration's training.
  - `trainingErrorDetails` string — Training error details, when training fails. Value is null when training succeeds.

## Other responses

- `default` — Error response

---

[API](https://skmtc.net/azure/apis/cognitiveservices-customvision-training.md) · [All operations](https://skmtc.net/azure/apis/cognitiveservices-customvision-training/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/azure/cognitiveservices-customvision-training/versions/82dfb72c78fa/schema)