Add a soft drop shadow behind the image.

Add a soft drop shadow behind the image. Drop this helper wherever you want to add a soft drop shadow behind the image with a single HTTP call. Send the documented inputs and the API streams back polished results you can hand directly to your users.

GETPOST/media/add-drop-shadow

Visual example

Sample request

GET https://api.dataczar.com/media/add-drop-shadow?url=https://images.unsplash.com/photo-1498050108023-c5249f4df085?auto=format&fit=crop&w=960&q=80&offset_x=20&offset_y=20&blur=35&ak=demo

Where this helper shines

Add a soft drop shadow behind the image. keeps media helpers on autopilot. Use it whenever you need to add a soft drop shadow behind the image without pausing a sprint or asking design/dev to jump in.

Trigger this helper whenever you need to add a soft drop shadow behind the image without waiting on a full deploy.
Drop it into automations (Zapier, Make, workers) to add a soft drop shadow behind the image as part of your workflow.
Share the GET URL so support and success can add a soft drop shadow behind the image safely using their Dataczar API key.

Copy & ship snippets

GET

Instant link

GET https://api.dataczar.app/media/add-drop-shadow?url=https%3A%2F%2Fexample.com%2Fsample.png&offset_x=15&offset_y=15&blur=25&ak=demo

Open directly in any browser, webhook, or low-code workflow.

curl

curl GET

curl "https://api.dataczar.app/media/add-drop-shadow?url=https%3A%2F%2Fexample.com%2Fsample.png&offset_x=15&offset_y=15&blur=25&ak=demo"

Swap ak=demo with your Dataczar API key.

curl

curl POST

curl -X POST "https://api.dataczar.app/media/add-drop-shadow?ak=demo" \
  -H 'Content-Type: application/json' \
  -d '{
  "url": "https://example.com/sample.png",
  "offset_x": 20,
  "offset_y": 30,
  "blur": 40,
  "color": "#38bdf8",
  "opacity": 60,
  "format": "png",
  "dryrun": true
}'

Send JSON payloads from back-end jobs, queues, or workers.

Parameters

Query Parameters

Name	Type	Description
url	string	Public HTTPS image URL or supply `file`.
offset_x	integer	Horizontal offset in px.
offset_y	integer	Vertical offset in px.
blur	integer	Blur radius for the shadow.
color	string	Shadow color (hex).
opacity	number	Shadow opacity 0-1.
format	string	Output format (png/jpg/webp).
dryrun	boolean	Return metadata only.

All helper calls accept your Dataczar key via the ak query parameter. Need one? Create or copy a key on Dataczar Connect and drop it into each request.

Responses

Status 200

Image transformed successfully.

"Binary image stream unless dryrun=true (JSON metadata)."

Examples

Request

"GET /img/add-drop-shadow?url=https://example.com/a.jpg&dryrun=1"

Response

{
  "ok": true,
  "data": {
    "operation": "add-drop-shadow"
  },
  "meta": {
    "dryrun": true
  }
}

Test Contracts

[
  {
    "name": "add-drop-shadow_dryrun",
    "method": "GET",
    "params": {
      "url": "https://example.com/a.jpg",
      "dryrun": true
    },
    "expect": {
      "operation": "add-drop-shadow"
    }
  }
]

API key

HTTP method

File uploads (multipart form-data)

Attach PDFs or images as multipart fields. We'll fill in the field names for you.

Files

file — Primary image

Query parameters

url optionaloffset_x optionaloffset_y optionalblur optionalcolor optionalopacity optionalformat optionaldryrun optional

Body parameters

We'll send these as JSON for POST/PUT/PATCH requests and as query params for GET.