Download an image and add a solid border before returning the transformed file.
Fetches a public image (or accepts direct upload), applies a configurable border color/width, and streams the new image back. Drop this helper wherever you want to download an image and add a solid border before returning the transformed file with a single HTTP call. Send the documented inputs and the API streams back polished results you can hand directly to your users.
/media/add-borderVisual example
Sample request
GET https://api.dataczar.com/media/add-border?url=https://images.unsplash.com/photo-1498050108023-c5249f4df085?auto=format&fit=crop&w=960&q=80&width=25&color=%2338bdf8&ak=demoWhere this helper shines
Download an image and add a solid border before returning the transformed file. keeps media helpers on autopilot. Use it whenever you need to download an image and add a solid border before returning the transformed file without pausing a sprint or asking design/dev to jump in.
- Trigger this helper whenever you need to download an image and add a solid border before returning the transformed file without waiting on a full deploy.
- Drop it into automations (Zapier, Make, workers) to download an image and add a solid border before returning the transformed file as part of your workflow.
- Share the GET URL so support and success can download an image and add a solid border before returning the transformed file safely using their Dataczar API key.
Copy & ship snippets
GET
Instant link
GET https://api.dataczar.app/media/add-border?url=https%3A%2F%2Fexample.com%2Fsample.png&width=640&color=%2338bdf8&format=png&ak=demoOpen directly in any browser, webhook, or low-code workflow.
curl
curl GET
curl "https://api.dataczar.app/media/add-border?url=https%3A%2F%2Fexample.com%2Fsample.png&width=640&color=%2338bdf8&format=png&ak=demo"Swap ak=demo with your Dataczar API key.
curl
curl POST
curl -X POST "https://api.dataczar.app/media/add-border?ak=demo" \
-H 'Content-Type: application/json' \
-d '{
"url": "https://example.com/sample.png",
"width": 640,
"color": "#38bdf8",
"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 to download. |
| width | integer | Border width in pixels (per side). |
| color | string | Border color (hex, CSS color name, or descriptive phrase like "warm blue"). |
| format | string | Output format. |
| dryrun | boolean | When true, skip downloading/processing and return metadata preview. |
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 bytes (PNG/JPG/WEBP)."Examples
Request
"GET /img/add-border?url=https://example.com/cat.jpg&color=%23ff00ff&width=30&ak=demo"Response
"Binary PNG (bordered cat image)."Request
"GET /img/add-border?url=https://example.com/cat.jpg&dryrun=1"Response
{
"ok": true,
"data": {
"source_url": "https://example.com/cat.jpg",
"border_width": 20,
"color": "#000000",
"format": "png"
},
"meta": {
"dryrun": true
}
}Test Contracts
[
{
"name": "dryrun_metadata",
"method": "GET",
"params": {
"url": "https://example.com/a.png",
"dryrun": true
},
"expect": {
"color": "#000000"
}
},
{
"name": "named_color_resolves",
"method": "GET",
"params": {
"url": "https://example.com/a.png",
"color": "purple",
"dryrun": true
},
"expect": {
"color": "#800080"
}
},
{
"name": "invalid_color",
"method": "GET",
"params": {
"url": "https://example.com/a.png",
"color": "!!!"
},
"expect_status": 400
}
]Grab your Dataczar API key
Every helper runs with the same simple API key. Sign in (or create a free Dataczar account) at Dataczar Connect to issue keys in seconds, then drop the key into any `ak=` parameter and start shipping.
Tip: reuse the same key across these helpers, or rotate keys per project from the Connect dashboard.