# Repositories

A **Repository** is the unified runtime container in Cloud and AI Gateway. It groups multiple resources under one logical endpoint and one operational surface for access control.

A repository can aggregate:

* **Cloud Storage** resources (S3/GCS/Azure Blob)
* **AI LLM** resources (OpenAI-compatible endpoint type)
* Other supported resource families as the platform evolves

## Why repositories matter

Repositories let your applications:

* consume multi-provider resources behind a consistent endpoint model,
* use repository-scoped API keys instead of account-wide credentials,
* apply governance and permissions at repository scope.

## UI structure

In the **Repositories** section, you typically find:

* **Overview**: high-level repository view and quick navigation.
* **Inventory**: list of repositories and entry point to create/open repositories.
* **API Keys**: centralized list and management view of repository API keys.

## Recommended workflow

1. Start with [Create a Repository](/guides/setup-the-cloud-and-ai-gateway/start-with-cloud-storage-1/create-a-repository.md) for naming, endpoint type, and initial resource attachment.
2. Continue with [Configure a Repository](/guides/setup-the-cloud-and-ai-gateway/start-with-cloud-storage-1/program-with-flashback.md) for detailed resource management and API key generation.

{% hint style="info" %}
Detailed creation properties, naming guidance, and key-generation behavior are documented in the two guide pages above to keep this overview page concise.
{% endhint %}

## Secret handling reminder

Repository API secrets are displayed once at key creation and then cannot be retrieved again from the UI. Store them immediately in your secure secret manager and rotate keys if a secret is lost.

Detailed platform behavior is documented in [Security and Secret Encryption](/support-reference/security-and-secret-encryption.md).

## API references

* [Repository Management APIs](/support-reference/platform-api-reference/repo-management.md)
* [Repo API Keys (Storage)](/support-reference/platform-api-reference/storage-apis/api_keys.md)
* [AI API Keys](/support-reference/platform-api-reference/ai-apis/ai-api-keys.md)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.flashback.tech/flashback-platform/cloud-and-ai-gateway/repositories.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.