---
title: "Laser Engraving Effect"
method: POST
path: "/effects/laserengraving"
tags: ["Effects"]
---

# Laser Engraving Effect

`POST /effects/laserengraving`

## Request

- Base URL: `https://api.picsart.io/tools/1.0`
- URL: `https://api.picsart.io/tools/1.0/effects/laserengraving`
- Auth: API key in header `X-Picsart-API-Key`

Apply a laser engraving effect to your stickers.

## Request body `multipart/form-data`

- object
  - `image` string, binary: Source image file (binary). (If this parameter is present, the other image source parameters must be empty.)
  - `image_url` string, uri: Source image URL. (If this parameter is present, the other image source parameters must be empty.)
  - `image_id` string: Deprecated. Source image ID of an image previously uploaded to Picsart or result image ID from a different API. (If this parameter is present, the other image source parameters must be empty.)
  - `engrave_color` string: Can be a hexcolor code (e.g., #82d5fa, #fff) or a color name (e.g., blue). For semi-transparency, 4-/8-digit hexcodes are also supported (e.g., #18d4ff87).
  - `background_color` string: Can be a hexcolor code (e.g., #82d5fa, #fff) or a color name (e.g., blue). For semi-transparency, 4-/8-digit hexcodes are also supported (e.g., #18d4ff87).
  - `format` 'JPG' | 'PNG' | 'WEBP' | 'SVG': Optionally select one of the output image formats (JPG is chosen if left blank). Options are as follows: * JPG * PNG * WEBP * SVG

## Response `200`

Success.

- object
  - `data` object
    - `id` string, nullable
    - `url` string, uri
  - `status` string

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `402`: Payment Required
- `403`: Forbidden
- `404`: Not Found
- `405`: Method Not Allowed
- `413`: Request Entity Too Large
- `415`: Unsupported Media Type
- `422`: Unprocessable Entity
- `429`: Too Many Requests
- `431`: Request Header Fields Too Large
- `500`: Internal Server Error
- `503`: Service Unavailable
- `529`: Overloaded. The model provider is overloaded and could not complete this request. Please retry shortly, or switch to a different model.

## Changes

- **2026-11-03** `466238206997`: 23 warning, 2 info
  - the optional response header `X-Correlation-Id` removed for the status `400`
  - the optional response header `X-Correlation-Id` removed for the status `401`
  - the optional response header `X-Correlation-Id` removed for the status `403`
  - the optional response header `X-Correlation-Id` removed for the status `404`
  - …21 more

[Operation history](https://skmtc.dev/picsart/apis/picsart-programmable-image-apis/changes/effects/laserengraving/post.md)

---

[API](https://skmtc.dev/picsart/apis/picsart-programmable-image-apis.md) - [All operations](https://skmtc.dev/picsart/apis/picsart-programmable-image-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/picsart/apis/picsart-programmable-image-apis/revisions/466238206997?raw)