Documentación

Primeros pasos

koigrid es cloud gestionado API-first. Crea una cuenta, genera una API key y gestiónalo todo desde tu terminal o tu agente de IA.

1. Crea una cuenta — Google o email.
2. Crea una API key en el dashboard.
3. Llama a la API REST, o pega el prompt del agente en Claude Code.

Autenticación

Cada endpoint /api/v1 se autentica con un Bearer token. Crea uno en Dashboard → API keys (se muestra una vez).

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

Almacenamiento (S3)

Almacenamiento de objetos compatible con S3. Crea buckets, acuña claves limitadas solo a tus buckets, y usa cualquier herramienta S3.

Crear un bucket

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

Obtener una access key S3 (limitada a tus buckets)

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

Úsala con 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

O con 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

Agentes IA

koigrid está hecho para que lo manejen LLMs. Apunta tu agente a /llms.txt y a la API, o pega el prompt del dashboard. Luego pídele crear buckets, acuñar claves, etc.

https://koigrid.com/llms.txt

Referencia de la API

Todos los endpoints requieren la cabecera: Authorization: Bearer koi_TU_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