---
title: "Core API Operation Examples"
slug: "core-api-operation-examples"
updated: 2026-02-03T15:04:24Z
published: 2026-02-03T15:04:24Z
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wasabi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Core API Operation Examples

## Buckets

A bucket is a container for storing objects (files). Each bucket must have a globally unique name.

#### Create a Bucket

**Method:** PUT

**Endpoint:**

```php-template
https://s3.<region>.wasabisys.com/<bucket-name>
```

**Request**(using cURL):

```bash
curl -X PUT \
  -H "Host: your-bucket-name.s3.wasabisys.com" \
  -H "Date: <date>" \
  -H "Authorization: AWS <AccessKey>:<Signature>" \
  https://s3.wasabisys.com/your-bucket-name
```

## Objects

An object is any file (image, video, document, etc.) stored in a bucket.

#### Upload an Object

**Method: PUT**

**Endpoint:**

```php-template
https://s3.<region>.wasabisys.com/<bucket-name>/<object-key>
```

**Request** (using cURL):

```bash
curl -X PUT \
  -T "localfile.jpg" \
  -H "Host: your-bucket-name.s3.wasabisys.com" \
  -H "Date: <date>" \
  -H "Authorization: AWS <AccessKey>:<Signature>" \
  https://your-bucket-name.s3.wasabisys.com/file.jpg
```

#### Download an Object

```bash
curl \
  -H "Authorization: AWS <AccessKey>:<Signature>" \
  https://your-bucket-name.s3.wasabisys.com/file.jpg -o downloaded.jpg
```