Tigris Object Operations

tigrisdata/skills/skills/tigris-object-operations

by tigrisdata668ea424758eNo license2 starsListed Oct 8, 2026Updated Oct 8, 2026Repository updated 2 months ago

Use when working with objects in Tigris Storage - uploading, downloading, deleting, listing, getting metadata, or generating presigned URLs

Instructions onlySoftware Development DevOps & Cloud

AI-generated overview

Reference for Tigris object storage operations: upload, download, delete, list, metadata and presigned URLs.

What it does: This skill is an instruction-only reference for working with objects in Tigris Storage using the @tigrisdata/storage package. It documents the put, get, remove, list, head and getPresignedUrl functions with code samples, option tables and common pitfalls. It also covers client-side browser uploads through the client package and notes that the Tigris CLI may need installing first.
When to use it: Use it when a task involves uploading, downloading, deleting, listing or inspecting objects in Tigris Storage, or when generating presigned URLs for temporary access or client uploads. It is also useful when handling large multipart uploads, pagination or overwrite and visibility options.
Requirements: Requires the @tigrisdata/storage package (and its client entry point for browser uploads), plus the Tigris CLI (@tigrisdata/cli), which the skill says to install via npm if unavailable. Network access and Tigris credentials are implied by the storage operations. No scripts ship with the skill; it contains instructions and code examples only.

Tigris Object Operations

Prerequisites

Before doing anything else, install the Tigris CLI if it's not already available:

If you need to install it, tell the user: "I'm installing the Tigris CLI (@tigrisdata/cli) so we can work with Tigris object storage."

Overview

Tigris Storage provides object operations: upload (put), download (get), delete (remove), list, metadata (head), and presigned URLs.

All methods return TigrisStorageResponse<T, E> - check error property first.

Quick Reference

Operation	Function	Key Parameters
Upload	`put(path, body, options)`	path, body, access, contentType
Download	`get(path, format, options)`	path, format (string/file/stream)
Delete	`remove(path, options)`	path
List	`list(options)`	prefix, limit, paginationToken
Metadata	`head(path, options)`	path
Presigned URL	`getPresignedUrl(path, options)`	path, operation (get/put)

Upload (put)

typescript

import { put } from "@tigrisdata/storage";
// Simple uploadconst result = await put("simple.txt", "Hello, World!");if (result.error) {  console.error("Error:", result.error);} else {  console.log("Uploaded:", result.data?.url);}
// Large file with progressconst result = await put("large.mp4", fileStream, {  multipart: true,  onUploadProgress: ({ loaded, total, percentage }) => {    console.log(`${loaded}/${total} bytes (${percentage}%)`);  },});
// Prevent overwriteconst result = await put("config.json", config, {  allowOverwrite: false,});

import { put } from "@tigrisdata/storage";
// Simple uploadconst result = await put("simple.txt", "Hello, World!");if (result.error) {  console.error("Error:", result.error);} else {  console.log("Uploaded:", result.data?.url);}
// Large file with progressconst result = await put("large.mp4", fileStream, {  multipart: true,  onUploadProgress: ({ loaded, total, percentage }) => {    console.log(`${loaded}/${total} bytes (${percentage}%)`);  },});
// Prevent overwriteconst result = await put("config.json", config, {  allowOverwrite: false,});

Put Options

Option	Values	Default	Purpose
access	public/private	-	Object visibility
addRandomSuffix	boolean	false	Avoid naming collisions
allowOverwrite	boolean	true	Allow replacing existing
contentType	string	inferred	MIME type
contentDisposition	inline/attachment	inline	Download behavior
multipart	boolean	false	Enable for large files
onUploadProgress	callback	-	Track upload progress

Download (get)

typescript

import { get } from "@tigrisdata/storage";
// Get as stringconst result = await get("object.txt", "string");if (result.error) {  console.error("Error:", result.error);} else {  console.log("Content:", result.data);}
// Get as file (triggers download in browser)const result = await get("object.pdf", "file", {  contentDisposition: "attachment",});
// Get as streamconst result = await get("video.mp4", "stream");const reader = result.data?.getReader();// Process stream...

import { get } from "@tigrisdata/storage";
// Get as stringconst result = await get("object.txt", "string");if (result.error) {  console.error("Error:", result.error);} else {  console.log("Content:", result.data);}
// Get as file (triggers download in browser)const result = await get("object.pdf", "file", {  contentDisposition: "attachment",});
// Get as streamconst result = await get("video.mp4", "stream");const reader = result.data?.getReader();// Process stream...

Get Options

Delete (remove)

typescript

import { remove } from "@tigrisdata/storage";
const result = await remove("object.txt");if (result.error) {  console.error("Error:", result.error);} else {  console.log("Deleted successfully");}

import { remove } from "@tigrisdata/storage";
const result = await remove("object.txt");if (result.error) {  console.error("Error:", result.error);} else {  console.log("Deleted successfully");}

List Objects

typescript

import { list } from "@tigrisdata/storage";
// List all objectsconst result = await list();console.log("Objects:", result.data?.items);
// List with prefix (folders)const result = await list({ prefix: "images/" });
// List with paginationconst allFiles = [];let currentPage = await list({ limit: 10 });allFiles.push(...currentPage.data?.items);
while (currentPage.data?.hasMore) {  currentPage = await list({    limit: 10,    paginationToken: currentPage.data?.paginationToken,  });  allFiles.push(...currentPage.data?.items);}

import { list } from "@tigrisdata/storage";
// List all objectsconst result = await list();console.log("Objects:", result.data?.items);
// List with prefix (folders)const result = await list({ prefix: "images/" });
// List with paginationconst allFiles = [];let currentPage = await list({ limit: 10 });allFiles.push(...currentPage.data?.items);
while (currentPage.data?.hasMore) {  currentPage = await list({    limit: 10,    paginationToken: currentPage.data?.paginationToken,  });  allFiles.push(...currentPage.data?.items);}

List Options

Option	Purpose
prefix	Filter keys starting with prefix
delimiter	Group keys (e.g., '/' for folders)
limit	Max objects to return (default: 100)
paginationToken	Continue from previous list
snapshotVersion	List from snapshot

Object Metadata (head)

typescript

import { head } from "@tigrisdata/storage";
const result = await head("object.txt");if (result.error) {  console.error("Error:", result.error);} else {  console.log("Metadata:", result.data);  // { path, size, contentType, modified, url, contentDisposition }}

import { head } from "@tigrisdata/storage";
const result = await head("object.txt");if (result.error) {  console.error("Error:", result.error);} else {  console.log("Metadata:", result.data);  // { path, size, contentType, modified, url, contentDisposition }}

Presigned URLs

typescript

import { getPresignedUrl } from "@tigrisdata/storage";
// Presigned URL for GET (temporary access)const result = await getPresignedUrl("object.txt", {  operation: "get",  expiresIn: 3600, // 1 hour});console.log("URL:", result.data?.url);
// Presigned URL for PUT (allow client upload)const result = await getPresignedUrl("upload.txt", {  operation: "put",  expiresIn: 600, // 10 minutes});

import { getPresignedUrl } from "@tigrisdata/storage";
// Presigned URL for GET (temporary access)const result = await getPresignedUrl("object.txt", {  operation: "get",  expiresIn: 3600, // 1 hour});console.log("URL:", result.data?.url);
// Presigned URL for PUT (allow client upload)const result = await getPresignedUrl("upload.txt", {  operation: "put",  expiresIn: 600, // 10 minutes});

Presigned URL Options

Common Mistakes

Mistake	Fix
Not checking `error` first	Always check `if (result.error)` before `result.data`
Wrong format in `get()`	Use 'string', 'file', or 'stream'
Forgetting `multipart: true`	Enable for files >100MB
Ignoring pagination	Use `hasMore` and `paginationToken`

Client-Side Uploads

For browser uploads, use the client package to upload directly to Tigris:

typescript

import { upload } from "@tigrisdata/storage/client";
const result = await upload(file.name, file, {  url: "/api/upload", // Your backend endpoint  onUploadProgress: ({ percentage }) => {    console.log(`${percentage}%`);  },});

import { upload } from "@tigrisdata/storage/client";
const result = await upload(file.name, file, {  url: "/api/upload", // Your backend endpoint  onUploadProgress: ({ percentage }) => {    console.log(`${percentage}%`);  },});

For initial setup, see file-storage.

Source and attribution

Source:tigrisdata/skillsinskills/tigris-object-operationsat commit668ea42

License: No license

Content belongs to its original authors. SourceWeft indexes it from a public repository.

Report or request removal

Tigris Object Operations

Tigris Object Operations

Prerequisites

Overview

Quick Reference

Upload (put)

Put Options

Download (get)

Get Options

Delete (remove)

List Objects

List Options

Object Metadata (head)

Presigned URLs

Presigned URL Options

Common Mistakes

Client-Side Uploads

Source and attribution

More from tigrisdata/skills

Tigris Snapshots Forking

Tigris Sdk Guide

Tigris Image Optimization

More in Software Development

Playground

M5 Onboard

Cardputer Buddy

Web Design Guidelines

Vercel React Native Skills

Vercel React Best Practices