---
title: "Remove background or foreground from images"
method: POST
path: "/remove"
tags: ["remove"]
---

# Remove background or foreground from images

`POST /remove`

From an input image, it returns the same image but without background or foreground.

## Response `200`

Successfully request proccesed.

- object
  - `correlation_id` string — Unique identifier for specific request.
  - `error` boolean — Unique identifier for specific request.
  - `message` string — Useful information (hopefully) about request.
  - `response` Response — Details of an error if it is the scenario.
    - `correlation_id` string — Useful information (hopefully) about request.
    - `error` boolean — Unique identifier for specific request.
    - `error_id` '001' | '002' | '003' — Error message if the request was unsuccessful. * 001 - An unspecified error has occurred during request processing. * 002 - Image is not reachable or the URL is invalid. * 003 - Invalid URL or required parameters not specified.
    - `message` string — Useful information (hopefully) about request.
    - `response` object — Reponse wrapper.
      - `image_base64` string — URL and filename - safe base64(url) encoded image.
      - `image_url` string — Internet accessible URL of an image.

## Other responses

- `default` — Error response with some information about.

---

[API](https://skmtc.dev/objectcut/apis/objectcut-api.md) · [All operations](https://skmtc.dev/objectcut/apis/objectcut-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/objectcut/objectcut-api/revisions/cb55318cc6e5/schema)