{
	"info": {
		"_postman_id": "markly-api-v1",
		"name": "Markly API v1",
		"description": "Markly API v1 - Watermark images programmatically with text or logo overlays, batch processing, and AI agent integration.\n\nBase URL: https://www.markly.cloud/api/v1\nDocs: https://www.markly.cloud/developers",
		"schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
	},
	"auth": {
		"type": "bearer",
		"bearer": [
			{
				"key": "token",
				"value": "{{api_key}}",
				"type": "string"
			}
		]
	},
	"variable": [
		{
			"key": "base_url",
			"value": "https://www.markly.cloud/api/v1"
		},
		{
			"key": "api_key",
			"value": "mkly_your_key"
		}
	],
	"item": [
		{
			"name": "Watermark",
			"item": [
				{
					"name": "Watermark Text",
					"request": {
						"method": "POST",
						"header": [],
						"body": {
							"mode": "formdata",
							"formdata": [
								{
									"key": "image_url",
									"value": "https://example.com/photo.jpg",
									"description": "URL of a remote image. Required if image file is not provided.",
									"type": "text"
								},
								{
									"key": "text",
									"value": "Copyright 2026",
									"description": "The watermark text. Max 200 characters.",
									"type": "text"
								},
								{
									"key": "size",
									"value": "48",
									"description": "Font size in pixels. Range: 10-200. Default: 48.",
									"type": "text",
									"disabled": true
								},
								{
									"key": "color",
									"value": "#ffffff",
									"description": "Hex color code. Default: #ffffff.",
									"type": "text",
									"disabled": true
								},
								{
									"key": "opacity",
									"value": "50",
									"description": "Opacity percentage. Range: 1-100. Default: 50.",
									"type": "text",
									"disabled": true
								},
								{
									"key": "angle",
									"value": "-25",
									"description": "Rotation angle in degrees. Range: -360 to 360. Default: -25.",
									"type": "text",
									"disabled": true
								},
								{
									"key": "position",
									"value": "center",
									"description": "One of: center, top-left, top-right, bottom-left, bottom-right. Default: center.",
									"type": "text",
									"disabled": true
								},
								{
									"key": "tile",
									"value": "false",
									"description": "Repeat the watermark across the image. Default: false.",
									"type": "text",
									"disabled": true
								},
								{
									"key": "font",
									"value": "",
									"description": "Font name. See available fonts on markly.cloud.",
									"type": "text",
									"disabled": true
								}
							]
						},
						"url": {
							"raw": "{{base_url}}/watermark/text",
							"host": ["{{base_url}}"],
							"path": ["watermark", "text"]
						},
						"description": "Add a text watermark to an image. Provide the image as a file upload or a remote URL."
					}
				},
				{
					"name": "Watermark Logo",
					"request": {
						"method": "POST",
						"header": [],
						"body": {
							"mode": "formdata",
							"formdata": [
								{
									"key": "image_url",
									"value": "https://example.com/photo.jpg",
									"description": "URL of a remote image. Required if image file is not provided.",
									"type": "text"
								},
								{
									"key": "logo_url",
									"value": "https://example.com/logo.png",
									"description": "URL of a remote logo image. Required if logo file is not provided.",
									"type": "text"
								},
								{
									"key": "position",
									"value": "bottom-right",
									"description": "One of: center, top-left, top-right, bottom-left, bottom-right. Default: bottom-right.",
									"type": "text",
									"disabled": true
								},
								{
									"key": "opacity",
									"value": "70",
									"description": "Opacity percentage. Range: 1-100. Default: 70.",
									"type": "text",
									"disabled": true
								},
								{
									"key": "scale",
									"value": "25",
									"description": "Logo scale percentage. Range: 5-80. Default: 25.",
									"type": "text",
									"disabled": true
								}
							]
						},
						"url": {
							"raw": "{{base_url}}/watermark/logo",
							"host": ["{{base_url}}"],
							"path": ["watermark", "logo"]
						},
						"description": "Overlay a logo on an image. Both image and logo can be uploaded or provided as URLs."
					}
				}
			]
		},
		{
			"name": "Batch",
			"item": [
				{
					"name": "Batch Upload",
					"request": {
						"method": "POST",
						"header": [],
						"body": {
							"mode": "formdata",
							"formdata": [
								{
									"key": "image_url",
									"value": "https://example.com/photo.jpg",
									"description": "URL of a remote image. Required if image file is not provided.",
									"type": "text"
								},
								{
									"key": "batch_id",
									"value": "",
									"description": "Existing batch ID. Omit to create a new batch.",
									"type": "text",
									"disabled": true
								}
							]
						},
						"url": {
							"raw": "{{base_url}}/batch/upload",
							"host": ["{{base_url}}"],
							"path": ["batch", "upload"]
						},
						"description": "Upload an image to a batch. Up to 20 images per batch."
					}
				},
				{
					"name": "Batch Start",
					"request": {
						"method": "POST",
						"header": [
							{
								"key": "Content-Type",
								"value": "application/json"
							}
						],
						"body": {
							"mode": "raw",
							"raw": "{\n    \"batch_id\": \"b_your_batch_id\",\n    \"mode\": \"text\",\n    \"text\": \"Copyright 2026\"\n}"
						},
						"url": {
							"raw": "{{base_url}}/batch/start",
							"host": ["{{base_url}}"],
							"path": ["batch", "start"]
						},
						"description": "Start processing a batch. All uploaded images will be watermarked with the specified settings."
					}
				},
				{
					"name": "Batch Status",
					"request": {
						"method": "GET",
						"header": [],
						"url": {
							"raw": "{{base_url}}/batch/:batch_id/status",
							"host": ["{{base_url}}"],
							"path": ["batch", ":batch_id", "status"],
							"variable": [
								{
									"key": "batch_id",
									"value": "b_your_batch_id",
									"description": "The batch ID from the upload step."
								}
							]
						},
						"description": "Poll the status of a batch. When complete, a download URL for the ZIP file is returned."
					}
				},
				{
					"name": "Batch Remove Image",
					"request": {
						"method": "DELETE",
						"header": [
							{
								"key": "Content-Type",
								"value": "application/json"
							}
						],
						"body": {
							"mode": "raw",
							"raw": "{\n    \"batch_id\": \"b_your_batch_id\",\n    \"image_id\": \"img_your_image_id\"\n}"
						},
						"url": {
							"raw": "{{base_url}}/batch/image",
							"host": ["{{base_url}}"],
							"path": ["batch", "image"]
						},
						"description": "Remove an image from a batch before processing starts."
					}
				}
			]
		},
		{
			"name": "Usage",
			"item": [
				{
					"name": "Check Usage",
					"request": {
						"method": "GET",
						"header": [],
						"url": {
							"raw": "{{base_url}}/usage",
							"host": ["{{base_url}}"],
							"path": ["usage"]
						},
						"description": "Check your API quota and usage statistics."
					}
				}
			]
		},
		{
			"name": "Anonymous",
			"description": "Requests without an API key. Rate-limited to 5/min, 20/day per IP. Output includes a markly.cloud watermark.",
			"item": [
				{
					"name": "Watermark Text (anonymous)",
					"request": {
						"auth": {
							"type": "noauth"
						},
						"method": "POST",
						"header": [],
						"body": {
							"mode": "formdata",
							"formdata": [
								{
									"key": "image_url",
									"value": "https://example.com/photo.jpg",
									"description": "URL of a remote image.",
									"type": "text"
								},
								{
									"key": "text",
									"value": "Copyright 2026",
									"description": "The watermark text.",
									"type": "text"
								}
							]
						},
						"url": {
							"raw": "{{base_url}}/watermark/text",
							"host": ["{{base_url}}"],
							"path": ["watermark", "text"]
						},
						"description": "Add a text watermark without authentication. Output includes a markly.cloud branding watermark."
					}
				}
			]
		}
	]
}