# Repository

This file outlines the Flashback API's repository management features, including creating, updating, listing, and monitoring repositories that group multiple storage buckets. Repositories can operate in MIRROR or BACKUP mode and support cloud providers like AWS, GCS, Azure, and S3/GCS-compatible services.

{% hint style="info" %}
To perform this operation, you must be authenticated by means of one of the following methods: [BearerAuth](https://docs.flashback.tech/support-reference/platform-api-reference/..#http-bearer-authentication).
{% endhint %}

## TypeScript Client Quick Links

```typescript
import { FlashbackClient } from '@flashback/client';
const client = new FlashbackClient({ accessToken: 'your-access-token' });

// List repositories
await client.repos.list();

// Create repository
await client.repos.create({ /* repo config */ });

// Update repository
await client.repos.update('repo-id', { /* updates */ });

// Get repository stats
await client.repos.getStats({ repoIds: ['repo-id'] });
```

## Repository API Calls <a href="#flashback-api-buckets" id="flashback-api-buckets"></a>

| Method                                                      | API Reference                                                                                                                      | Description                                                                        |
| ----------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------- |
| <mark style="color:green;">`GET`</mark> `/repo`             | [**get\_\_repo**](https://docs.flashback.tech/support-reference/platform-api-reference/repo-management/get__repo)                  | Retrieve all repositories for the authenticated user's organization.               |
| <mark style="color:green;">`GET`</mark>`/repo/stats`        | [**get\_\_repo\_stats**](https://docs.flashback.tech/support-reference/platform-api-reference/repo-management/get__repo_stats)     | Fetch usage and performance statistics for one or more repositories.               |
| <mark style="color:orange;">`POST`</mark>`/repo`            | [**post\_\_repo**](https://docs.flashback.tech/support-reference/platform-api-reference/repo-management/post__repo)                | Create a new storage repository linking multiple buckets in MIRROR or BACKUP mode. |
| <mark style="color:purple;">`PUT`</mark>` ``/repo/{repoId}` | [**put\_\_repo\_{repoId}**](https://docs.flashback.tech/support-reference/platform-api-reference/repo-management/put__repo_repoid) | Update an existing repository’s configuration including its bucket layout.         |
| <mark style="color:red;">`DELETE`</mark>`/repo/{id}`        | [**delete\_\_repo\_{Id}**](https://docs.flashback.tech/support-reference/platform-api-reference/repo-management/delete__repo)      | Delete a storage repository (hard delete for Web3 users, soft delete for others).  |