File Upload - JigsawStack

Overview

The JigsawStack File Storage API allows you to easily upload, manage, and serve files for your applications. Files are stored securely and can be accessed via URL, making it an ideal solution for image uploads, document storage, or any file-handling needs in your applications.

Note: The file upload method is ideal for files up to 100MB in size.

Secure file storage with fine-grained access control
Simple integration with other JigsawStack APIs
Automatic content-type detection
Support for overwriting existing files
Customizable file accessibility

API Endpoint

POST /v1/store/upload

Quick Start

JavaScript

import { JigsawStack } from "jigsawstack";

const jigsaw = JigsawStack({
apiKey: "your-api-key",
});

const imageFetch = await fetch("https://jigsawstack.com/preview/object-detection-example-input.jpg");
const blob = await imageFetch.blob();

const response = await jigsaw.store.upload(blob, {
key: "test-key",
overwrite: true,
});

Response Example

{
  "key": "test-key",
  "url": "https://api.jigsawstack.com/v1/store/file/read/1234",
  "size": 1024,
}

Advanced Usage

By default, trying to upload a file with a name that already exists will return an error. To replace an existing file, use the overwrite parameter:

Overwriting Existing Files

const result = await jigsaw.store.upload(imageFile, {
  filename: "beach_house.png",
  overwrite: true
});

While the API automatically detects the content type of uploaded files, you can explicitly set it with the content_type parameter:

Specifying Content Type

const result = await jigsaw.store.upload(imageFile, {
  filename: "beach_house.png",
  content_type: "image/png"
});

Uploaded files are private by default. To make a file accessible without authentication, append your public key to the URL:

Making Files Publicly Accessible

const publicFileUrl = `${result.url}?x-api-key=${publicKey}`;

You can use an uploaded file with other JigsawStack APIs by referencing its key in the file_store_key parameter:

Using Uploaded Files with Other JigsawStack APIs

// JavaScript example: Upload an image and use it with Vision OCR
const uploadResult = await jigsaw.store.upload(imageFile, {
  filename: "receipt.jpg"
});

// Use the uploaded image with the Vision OCR API
const ocrResult = await jigsaw.vision.vocr({
  prompt: "Extract all text from this receipt",
  file_store_key: uploadResult.key
});

Find more information on File Upload API here

​Overview

​API Endpoint

​Quick Start

​Response Example

​Advanced Usage

Overview

API Endpoint

Quick Start

Response Example

Advanced Usage