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

# Memory API

> Store and search multimodal content with AI

## Overview

Store videos, images, and text in buckets. Search everything with natural language.

<CardGroup cols={2}>
  <Card title="Buckets" icon="folder">
    Organize content into memory buckets
  </Card>

  <Card title="Upload" icon="upload">
    Images, videos, text — even combined
  </Card>

  <Card title="Search" icon="magnifying-glass">
    AI-powered natural language search
  </Card>

  <Card title="Simple" icon="bolt">
    One API key, 6 endpoints
  </Card>
</CardGroup>

## Quick Start

```python theme={null}
import requests

# 1. Create a bucket
response = requests.post(
    "https://memoryapi-production.up.railway.app/memory-bucket/create",
    headers={"X-API-Key": "xinobi"},
    json={"name": "My Memories"}
)
bucket_id = response.json()["bucket_id"]

# 2. Upload text (JSON)
requests.post(
    "https://memoryapi-production.up.railway.app/upload",
    headers={"X-API-Key": "xinobi", "Content-Type": "application/json"},
    json={"unique_id": bucket_id, "text": "Beach sunset in Hawaii"}
)

# 3. Upload image (multipart form)
requests.post(
    "https://memoryapi-production.up.railway.app/upload/file",
    headers={"X-API-Key": "xinobi"},
    data={"unique_id": bucket_id},
    files={"file": open("sunset.jpg", "rb")}
)

# 4. Search
response = requests.post(
    "https://memoryapi-production.up.railway.app/search",
    headers={"X-API-Key": "xinobi"},
    json={"query": "beach vacation", "unique_id": bucket_id}
)
print(response.json()["results"])
```

## Endpoints

| Method | Endpoint                | Description               |
| ------ | ----------------------- | ------------------------- |
| `POST` | `/memory-bucket/create` | Create a bucket           |
| `POST` | `/memory-bucket/delete` | Delete a bucket           |
| `POST` | `/upload`               | Upload text/URL (JSON)    |
| `POST` | `/upload/file`          | Upload image/video (form) |
| `POST` | `/search`               | Search a bucket           |
| `POST` | `/search/multiple`      | Search multiple buckets   |

## Auth

```
X-API-Key: xinobi
```

## Base URL

```
https://memoryapi-production.up.railway.app
```