tinify

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "source": {
      "type": "object",
      "description": "The source value",
      "properties": {
        "url": {
          "type": "string",
          "description": "URL of the image to compress. Must be publicly accessible."
        }
      },
      "required": [
        "url"
      ]
    }
  },
  "required": [
    "PCID",
    "source"
  ]
}

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "output_token": {
      "type": "string",
      "description": "The output token from a previous compression. This is the path segment from the Location header or output.url returned by the compress endpoint (e.g., the part after /output/ in the URL)."
    },
    "convert": {
      "type": "object",
      "description": "Convert the image to a different format.",
      "properties": {
        "type": {
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "image/webp",
              "image/jpeg",
              "image/png",
              "image/avif"
            ]
          },
          "description": "Target format MIME type. Use '*/*' or an array of types to let Tinify pick the smallest. Supported: image/webp, image/jpeg, image/png, image/avif."
        }
      }
    },
    "preserve": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "copyright",
          "creation",
          "location"
        ]
      },
      "description": "Metadata to preserve from the original image."
    },
    "resize": {
      "type": "object",
      "description": "Resize the image. Requires at least a method and one dimension.",
      "properties": {
        "method": {
          "type": "string",
          "description": "Resize method. 'scale' scales proportionally (provide width OR height). 'fit' scales to fit within dimensions. 'cover' scales and crops to exact dimensions. 'thumb' is like cover but uses smart cropping.",
          "enum": [
            "scale",
            "fit",
            "cover",
            "thumb"
          ]
        },
        "width": {
          "type": "integer",
          "description": "Target width in pixels"
        },
        "height": {
          "type": "integer",
          "description": "Target height in pixels"
        }
      }
    },
    "store": {
      "type": "object",
      "description": "Store the result directly to a cloud storage service instead of returning it.",
      "properties": {
        "service": {
          "type": "string",
          "description": "Cloud storage service: 's3' for Amazon S3, 'gcs' for Google Cloud Storage",
          "enum": [
            "s3",
            "gcs"
          ]
        },
        "path": {
          "type": "string",
          "description": "Storage path including bucket name (e.g., 'my-bucket/images/photo.jpg')"
        },
        "aws_access_key_id": {
          "type": "string",
          "description": "AWS access key ID (required for S3)"
        },
        "aws_secret_access_key": {
          "type": "string",
          "description": "AWS secret access key (required for S3)"
        },
        "region": {
          "type": "string",
          "description": "AWS region (required for S3, e.g., 'us-west-1')"
        },
        "gcp_access_token": {
          "type": "string",
          "description": "GCP OAuth access token (required for GCS)"
        },
        "headers": {
          "type": "object",
          "description": "Additional headers to set on the stored object (e.g., Cache-Control)"
        },
        "acl": {
          "type": "string",
          "description": "Access control for S3 objects. Use 'no-acl' to use the bucket's default ACL.",
          "enum": [
            "public-read",
            "no-acl"
          ]
        }
      },
      "required": [
        "service",
        "path"
      ]
    },
    "transform": {
      "type": "object",
      "description": "Apply transformations. Currently only supports setting a background color for transparent-to-JPEG conversions.",
      "properties": {
        "background": {
          "type": "string",
          "description": "Background color as hex (#000000) or name (white, black). Required when converting transparent images to JPEG."
        }
      }
    }
  },
  "required": [
    "PCID",
    "output_token"
  ]
}