Create Memory Bucket

curl -X POST "https://memoryapi-production.up.railway.app/memory-bucket/create" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: xinobi" \
  -d '{
    "name": "My Memory Bucket",
    "description": "Personal memories and notes"
  }'

{
  "name": "My Memory Bucket",
  "description": "Personal memories and notes"
}

{
  "success": true,
  "bucket_id": "550e8400-e29b-41d4-a716-446655440000",
  "unique_id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "My Memory Bucket",
  "description": "Personal memories and notes",
  "created_at": "2024-01-01T00:00:00",
  "message": "New memory bucket created"
}

POST

memory-bucket

create

curl -X POST "https://memoryapi-production.up.railway.app/memory-bucket/create" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: xinobi" \
  -d '{
    "name": "My Memory Bucket",
    "description": "Personal memories and notes"
  }'

{
  "name": "My Memory Bucket",
  "description": "Personal memories and notes"
}

{
  "success": true,
  "bucket_id": "550e8400-e29b-41d4-a716-446655440000",
  "unique_id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "My Memory Bucket",
  "description": "Personal memories and notes",
  "created_at": "2024-01-01T00:00:00",
  "message": "New memory bucket created"
}

Headers

string

required

API authentication key (secret: xinobi)

Request Body

string

required

Name of the memory bucket

string

Optional description for the memory bucket

Response

boolean

Whether the operation was successful

string

Unique identifier for the created bucket

string

Unique identifier (same as bucket_id)

string

Name of the created bucket

string

Description of the created bucket

string

ISO 8601 timestamp of creation

string

Success message

curl -X POST "https://memoryapi-production.up.railway.app/memory-bucket/create" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: xinobi" \
  -d '{
    "name": "My Memory Bucket",
    "description": "Personal memories and notes"
  }'

{
  "name": "My Memory Bucket",
  "description": "Personal memories and notes"
}

{
  "success": true,
  "bucket_id": "550e8400-e29b-41d4-a716-446655440000",
  "unique_id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "My Memory Bucket",
  "description": "Personal memories and notes",
  "created_at": "2024-01-01T00:00:00",
  "message": "New memory bucket created"
}

Note: When a bucket is created, it is automatically seeded with:

A “hi” text memory
A blank placeholder image

Getting Started

Memory Buckets

Upload

Search

System

Create Memory Bucket

Headers

Request Body

Response

​Headers

​Request Body

​Response

Headers

Request Body

Response