Documentation

Getting started

koigrid is API-first managed cloud. Create an account, generate an API key, and drive everything from your terminal or your AI agent.

1. Create an account — Google or email.
2. Create an API key in the dashboard.
3. Call the REST API, or paste the agent prompt into Claude Code.

Authentication

Every /api/v1 endpoint authenticates with a Bearer token. Create one in Dashboard → API keys (it’s shown once).

curl https://koigrid.com/api/v1/me \
  -H "Authorization: Bearer koi_YOUR_KEY"

Storage (S3)

S3-compatible object storage. Create buckets, mint access keys scoped to only your buckets, and use any S3 tool.

Create a bucket

curl -X POST https://koigrid.com/api/v1/buckets \
  -H "Authorization: Bearer koi_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"backups"}'

Get an S3 access key (scoped to your buckets)

curl -X POST https://koigrid.com/api/v1/storage/keys \
  -H "Authorization: Bearer koi_YOUR_KEY"
# → { accessKey, secretKey, endpoint }  (secret shown once)

Use it with aws-cli

aws configure set aws_access_key_id  YOUR_ACCESS_KEY
aws configure set aws_secret_access_key YOUR_SECRET_KEY

aws s3 ls --endpoint-url https://s3.koigrid.com
aws s3 cp ./file.txt s3://YOUR_BUCKET/ --endpoint-url https://s3.koigrid.com

Or with rclone (~/.config/rclone/rclone.conf)

[koigrid]
type = s3
provider = Other
access_key_id = YOUR_ACCESS_KEY
secret_access_key = YOUR_SECRET_KEY
endpoint = https://s3.koigrid.com

# then: rclone ls koigrid:YOUR_BUCKET

AI agents

koigrid is built to be driven by LLMs. Point your agent at /llms.txt and our API, or paste the prompt from the dashboard. Then ask it to create buckets, mint keys, etc.

https://koigrid.com/llms.txt

API reference

All endpoints require the header: Authorization: Bearer koi_YOUR_KEY

Base URL

• GET/me
• GET/buckets
• POST/buckets
• DELETE/buckets/:id
• GET/storage/keys
• POST/storage/keys
• DELETE/storage/keys/:id
• GET/apps
• POST/apps
• GET/usage