---
title: "POST /areaOfInterest"
method: POST
path: "/areaOfInterest"
---

# POST /areaOfInterest

`POST /areaOfInterest`

This operation returns a bounding box around the most important area of the image.
A successful response will be returned in JSON. If the request failed, the response contains an error code and a message to help determine what went wrong.
Upon failure, the error code and an error message are returned. The error code could be one of InvalidImageUrl, InvalidImageFormat, InvalidImageSize, NotSupportedImage, FailedToProcess, Timeout, or InternalServerError.

## Request body

- ImageUrl
  - `url` string, required — Publicly reachable URL of an image.

## Response `200`

The response includes the extracted area of interest in JSON format.

- AreaOfInterestResult, nullable — Result of AreaOfInterest operation.
  - `areaOfInterest` BoundingRect — A bounding box for an area inside an image.
    - `h` integer — Height measured from the top-left point of the area, in pixels.
    - `w` integer — Width measured from the top-left point of the area, in pixels.
    - `x` integer — X-coordinate of the top left point of the area, in pixels.
    - `y` integer — Y-coordinate of the top left point of the area, in pixels.
  - `metadata` ImageMetadata, nullable — Image metadata.
    - `format` string, nullable — Image format.
    - `height` integer — Image height, in pixels.
    - `width` integer — Image width, in pixels.
  - `requestId` string, nullable — Id of the REST API request.

## Other responses

- `default` — Error response.

---

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