Skip to main content
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"
  }'

{
  "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

​
X-API-Key
string
required
API authentication key (secret: xinobi)

​
Request Body

​
name
string
required
Name of the memory bucket
​
description
string
Optional description for the memory bucket

​
Response

​
success
boolean
Whether the operation was successful
​
bucket_id
string
Unique identifier for the created bucket
​
unique_id
string
Unique identifier (same as bucket_id)
​
name
string
Name of the created bucket
​
description
string
Description of the created bucket
​
created_at
string
ISO 8601 timestamp of creation
​
message
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"
  }'

{
  "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