{ "opencollection": "1.0.0", "info": { "name": "Supabase Auth Admin Objects API", "version": "2.0.0" }, "request": { "auth": { "type": "apikey", "key": "apikey", "value": "{{apikey}}", "placement": "header" } }, "items": [ { "info": { "name": "Objects", "type": "folder" }, "items": [ { "info": { "name": "Upload a file", "type": "http" }, "http": { "method": "POST", "url": "https://{project_ref}.supabase.co/auth/v1/object/:bucketName/:objectPath", "headers": [ { "name": "x-upsert", "value": "" } ], "params": [ { "name": "bucketName", "value": "", "type": "path", "description": "Name of the storage bucket" }, { "name": "objectPath", "value": "", "type": "path", "description": "Path to the object within the bucket, including folder hierarchy and filename." } ], "body": { "type": "multipart-form", "data": [ { "name": "file", "type": "text", "value": "" }, { "name": "cacheControl", "type": "text", "value": "" } ] } }, "docs": "Uploads a file to the specified path within a bucket. If a file already exists at the path, the upload will fail unless the upsert option is used. Supports standard uploads and multipart form data." }, { "info": { "name": "Update (replace) a file", "type": "http" }, "http": { "method": "PUT", "url": "https://{project_ref}.supabase.co/auth/v1/object/:bucketName/:objectPath", "params": [ { "name": "bucketName", "value": "", "type": "path", "description": "Name of the storage bucket" }, { "name": "objectPath", "value": "", "type": "path", "description": "Path to the object within the bucket, including folder hierarchy and filename." } ], "body": { "type": "multipart-form", "data": [ { "name": "file", "type": "text", "value": "" }, { "name": "cacheControl", "type": "text", "value": "" } ] } }, "docs": "Replaces an existing file at the specified path with new content. The file must already exist." }, { "info": { "name": "Delete a file", "type": "http" }, "http": { "method": "DELETE", "url": "https://{project_ref}.supabase.co/auth/v1/object/:bucketName/:objectPath", "params": [ { "name": "bucketName", "value": "", "type": "path", "description": "Name of the storage bucket" }, { "name": "objectPath", "value": "", "type": "path", "description": "Path to the object within the bucket, including folder hierarchy and filename." } ] }, "docs": "Permanently deletes a file at the specified path within a bucket." }, { "info": { "name": "Download a private file", "type": "http" }, "http": { "method": "GET", "url": "https://{project_ref}.supabase.co/auth/v1/object/authenticated/:bucketName/:objectPath", "params": [ { "name": "bucketName", "value": "", "type": "path", "description": "Name of the storage bucket" }, { "name": "objectPath", "value": "", "type": "path", "description": "Path to the object within the bucket, including folder hierarchy and filename." } ] }, "docs": "Downloads a file from a private bucket. Requires authentication and appropriate Row Level Security permissions." }, { "info": { "name": "Download a public file", "type": "http" }, "http": { "method": "GET", "url": "https://{project_ref}.supabase.co/auth/v1/object/public/:bucketName/:objectPath", "params": [ { "name": "bucketName", "value": "", "type": "path", "description": "Name of the storage bucket" }, { "name": "objectPath", "value": "", "type": "path", "description": "Path to the object within the bucket, including folder hierarchy and filename." } ] }, "docs": "Downloads a file from a public bucket. Does not require authentication." }, { "info": { "name": "Create a signed URL", "type": "http" }, "http": { "method": "POST", "url": "https://{project_ref}.supabase.co/auth/v1/object/sign/:bucketName/:objectPath", "params": [ { "name": "bucketName", "value": "", "type": "path", "description": "Name of the storage bucket" }, { "name": "objectPath", "value": "", "type": "path", "description": "Path to the object within the bucket, including folder hierarchy and filename." } ], "body": { "type": "json", "data": "{}" } }, "docs": "Generates a time-limited signed URL for accessing a private file without authentication. Useful for sharing temporary access to files." }, { "info": { "name": "List objects in a bucket", "type": "http" }, "http": { "method": "POST", "url": "https://{project_ref}.supabase.co/auth/v1/object/list/:bucketName", "params": [ { "name": "bucketName", "value": "", "type": "path", "description": "Name of the storage bucket" } ], "body": { "type": "json", "data": "{}" } }, "docs": "Returns a list of objects within a bucket, optionally filtered by prefix (folder path). Supports pagination with limit and offset." }, { "info": { "name": "Move a file", "type": "http" }, "http": { "method": "POST", "url": "https://{project_ref}.supabase.co/auth/v1/object/move", "body": { "type": "json", "data": "{}" } }, "docs": "Moves a file from one location to another within the same bucket or across buckets. Can also be used to rename files." }, { "info": { "name": "Copy a file", "type": "http" }, "http": { "method": "POST", "url": "https://{project_ref}.supabase.co/auth/v1/object/copy", "body": { "type": "json", "data": "{}" } }, "docs": "Creates a copy of a file at a new location within the same bucket or across buckets." } ] } ], "bundled": true }