---
title: "Add the provided images urls to the set of training images."
method: POST
path: "/projects/{projectId}/images/urls"
tags: ["ImageApi"]
---

# Add the provided images urls to the set of training images.

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

This API accepts a batch of urls, and optionally tags, to create images. There is a limit of 64 images and 20 tags.

## Path parameters

- `projectId` string, uuid, required

## Request body

- ImageUrlCreateBatch
  - `images` ImageUrlCreateEntry[]
    - `regions` Region[]
      - `height` number, float, required — Height.
      - `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.
    - `tagIds` string[]
    - `url` string, required — Url of the image.
  - `tagIds` string[]

## Response `200`

OK

- ImageCreateSummary
  - `images` ImageCreateResult[] — List of the image creation results.
    - `image` Image — Image model to be sent as JSON.
      - `created` string, date-time — Date the image was created.
      - `height` integer — Height of the image.
      - `id` string, uuid — Id of the image.
      - `originalImageUri` string — The URI to the original uploaded image.
      - `regions` ImageRegion[], nullable — Regions associated with this image.
        - `created` string, date-time
        - `height` number, float, required — Height.
        - `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.
      - `resizedImageUri` string — The URI to the (resized) image used for training.
      - `tags` ImageTag[], nullable — Tags associated with this image.
        - `created` string, date-time
        - `tagId` string, uuid
        - `tagName` string
      - `thumbnailUri` string — The URI to the thumbnail of the original image.
      - `width` integer — Width of the image.
    - `sourceUrl` string — Source URL of the image.
    - `status` 'OK' | 'OKDuplicate' | 'ErrorSource' | 'ErrorImageFormat' | 'ErrorImageSize' | 'ErrorStorage' | 'ErrorLimitExceed' | 'ErrorTagLimitExceed' | 'ErrorRegionLimitExceed' | 'ErrorUnknown' | 'ErrorNegativeAndRegularTagOnSameImage' — Status of the image creation.
  - `isBatchSuccessful` boolean — True if all of the images in the batch were created successfully, otherwise false.

## 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)