---
description: Clearcut copy a batch background. Learn how to remove image backgrounds, manage jobs and work with credits in your application.
title: Copy a batch background | Clearcut
image: https://clearcut.sh/og/docs.png
---

GUIDES

[Quick start](https://clearcut.sh/docs)[Authentication](https://clearcut.sh/docs/authentication)[Credits & billing](https://clearcut.sh/docs/credits)[Limits & retries](https://clearcut.sh/docs/limits)[Examples](https://clearcut.sh/docs/examples)[Errors](https://clearcut.sh/docs/errors)

API REFERENCE

[POSTRemove a background](https://clearcut.sh/docs/remove-background)[GETremove.bg account info](https://clearcut.sh/docs/removebg-account)[POSTCreate an image job](https://clearcut.sh/docs/create-job)[GETGet a job](https://clearcut.sh/docs/get-job)[GETList images](https://clearcut.sh/docs/list-jobs)[DELETEDelete an image](https://clearcut.sh/docs/delete-job)[GETDownload a result](https://clearcut.sh/docs/download)[POSTExport an edited image](https://clearcut.sh/docs/export)[POSTUpload a background](https://clearcut.sh/docs/background)[POSTExport a ZIP batch](https://clearcut.sh/docs/batch-export)[POSTCopy a batch background](https://clearcut.sh/docs/batch-background)[POSTSmart Brush](https://clearcut.sh/docs/smart-brush)[POSTGenerate a scene](https://clearcut.sh/docs/generate-scene)[GETCredit balance](https://clearcut.sh/docs/account)[POSTRetry a failed image](https://clearcut.sh/docs/retry-job)[GETRecent usage](https://clearcut.sh/docs/usage)[Download OpenAPI](https://clearcut.sh/openapi.json)

API reference / Copy a batch background

# Copy a batch background

Copy an uploaded background to 1–100 images in your account. Use the returned per-image URLs when exporting.

POST`/api/batch/background`

Authenticate with `X-API-Key`. Keep your key on your server; never embed it in a public website.

## Request parameters

`source_id`string**required**

Image owning the source background.

`background`string**required**

Source background URL.

`ids`array**required**

Target image IDs.

## Response

200 · Success

{
  "image_id": "/api/files/image_id/bg_background-id.png"
}

Errors use a structured `error.code` and `error.message`. [See error handling →](https://clearcut.sh/docs/errors)

## Example request

This example calls the endpoint shown here.

cURLPythonNode.js

```
curl https://clearcut.sh/api/batch/background \
  -X POST -H "X-API-Key: $CLEARCUT_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"source_id":"SOURCE_IMAGE_ID","background":"/api/files/SOURCE_IMAGE_ID/bg-BACKGROUND_ID.png","ids":["IMAGE_ID"]}'
```

[More examples →](https://clearcut.sh/docs/examples)

Need help?

Prefer email? [support@clearcut.sh](mailto:support@clearcut.sh)

Copy a batch background | Clearcut

```json
{"@context":"https://schema.org","@graph":[{"@type":"Organization","@id":"https://clearcut.sh/#organization","name":"Clearcut","url":"https://clearcut.sh","logo":"https://clearcut.sh/apple-touch-icon.png","email":"support@clearcut.sh","description":"An independent image background removal service operated by chern0.dev.","contactPoint":{"@type":"ContactPoint","email":"support@clearcut.sh","contactType":"customer support"}},{"@type":"WebSite","@id":"https://clearcut.sh/#website","url":"https://clearcut.sh","name":"Clearcut","description":"Remove image backgrounds with Clearcut. Get 30 free credits every month for the website and API. Full-resolution downloads, no watermark. Packs from $3.","inLanguage":"en","publisher":{"@id":"https://clearcut.sh/#organization"}}]}
```