---
title: "Create a set of image regions."
method: POST
path: "/projects/{projectId}/images/regions"
tags: ["ImageApi"]
---

# Create a set of image regions.

`POST /projects/{projectId}/images/regions`

This API accepts a batch of image regions, and optionally tags, to update existing images with region information.
There is a limit of 64 entries in the batch.

## Path parameters

- `projectId` string, uuid, required

## Request body

- ImageRegionCreateBatch — Batch of image region information to create.
  - `regions` ImageRegionCreateEntry[]
    - `height` number, float, required — Height.
    - `imageId` string, uuid, required — Id of the image.
    - `left` number, float, required — Coordinate of the left boundary.
    - `tagId` string, uuid, required — Id of the tag associated with this region.
    - `top` number, float, required — Coordinate of the top boundary.
    - `width` number, float, required — Width.

## Response `200`

OK

- ImageRegionCreateSummary
  - `created` ImageRegionCreateResult[], nullable
    - `created` string, date-time
    - `height` number, float, required — Height.
    - `imageId` string, uuid
    - `left` number, float, required — Coordinate of the left boundary.
    - `regionId` string, uuid
    - `tagId` string, uuid, required — Id of the tag associated with this region.
    - `tagName` string
    - `top` number, float, required — Coordinate of the top boundary.
    - `width` number, float, required — Width.
  - `duplicated` ImageRegionCreateEntry[], nullable
    - `height` number, float, required — Height.
    - `imageId` string, uuid, required — Id of the image.
    - `left` number, float, required — Coordinate of the left boundary.
    - `tagId` string, uuid, required — Id of the tag associated with this region.
    - `top` number, float, required — Coordinate of the top boundary.
    - `width` number, float, required — Width.
  - `exceeded` ImageRegionCreateEntry[], nullable
    - `height` number, float, required — Height.
    - `imageId` string, uuid, required — Id of the image.
    - `left` number, float, required — Coordinate of the left boundary.
    - `tagId` string, uuid, required — Id of the tag associated with this region.
    - `top` number, float, required — Coordinate of the top boundary.
    - `width` number, float, required — Width.

## Other responses

- `default` — Error response

---

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