---
title: "Remove Object"
method: POST
path: "/v1/remove-object"
tags: ["generate"]
---

# Remove Object

`POST /v1/remove-object`

Remove a masked object from a given image synchronously. Supply the image and a binary mask marking the region to remove (white = remove); the masked region is regenerated to blend with the surrounding scene. Supported image formats include JPEG, PNG, and WebP. Image links are available for a limited period of time; if you would like to keep the image, you must download it.

## Response `200`

Object removed successfully.

- RemoveObjectResponse — The response containing the image with the masked object removed. Image links are available for a limited period of time; if you would like to keep the image, you must download it.
  - `created` string, date-time, required — The time the request was created.
  - `data` RemoveObjectImageObject[], required — A list containing the single edited image. The endpoint always returns exactly one entry.
    - `url` string, uri, nullable — The direct link to the edited image. Empty when the image fails safety checks.
    - `is_image_safe` boolean, required — Whether the edited image passes safety checks. If false, the url field will be empty.

## Other responses

- `400` — Invalid input provided.
- `401` — Not authorized to remove object.
- `422` — Initial image failed the safety checks.
- `429` — Too many requests.

## Changes

> 16 revisions in range; 13 could not be searched.

- **2026-07-31** `3cece82bbf1d` — 1 warning
  - removed the request property `enable_snapping`
- **2026-07-26** `7e5e0fb30776` — 1 info
  - added the new optional request property `enable_snapping`

[Change history](https://skmtc.dev/ideogram/apis/ideogram-openapi-3-0/changes/v1/remove-object/post.md)

---

[API](https://skmtc.dev/ideogram/apis/ideogram-openapi-3-0.md) · [All operations](https://skmtc.dev/ideogram/apis/ideogram-openapi-3-0/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ideogram/ideogram-openapi-3-0/revisions/3eb3216eed39/schema)