Integration

Inventory API for trusted tools.

Give AI assistants, automations, and scripts a scoped view of the personal or small-team inventory you choose to share.

Get Your API Key

Go to Settings, create an API key, and choose Read only, Manage items, or Full agent access. Copy it immediately. You'll only see it once.

Agents that create containers, upload media, or analyze images need Full agent access. Start with Read only when write access is unnecessary. OpenAPI specification

Query Your Inventory

List all items (full detail)

curl -H "Authorization: Bearer kb_YOUR_KEY" \
  https://klutt3rbox.ck42x.com/api/v1/inventory

Compact format (optimized for LLM context windows)

curl -H "Authorization: Bearer kb_YOUR_KEY" \
  "https://klutt3rbox.ck42x.com/api/v1/inventory?format=compact"

AI-safe inventory context packet

curl -H "Authorization: Bearer kb_YOUR_KEY" \
  "https://klutt3rbox.ck42x.com/api/v1/agent-context?project=build%20a%20garage%20shelf"

Search for specific items

curl -H "Authorization: Bearer kb_YOUR_KEY" \
  "https://klutt3rbox.ck42x.com/api/v1/inventory?search=batteries"

Filter by container

curl -H "Authorization: Bearer kb_YOUR_KEY" \
  "https://klutt3rbox.ck42x.com/api/v1/inventory?container=garage-shelf"

Create or update a container

curl -X POST -H "Authorization: Bearer kb_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"containerKey":"garage-shelf","label":"Garage Shelf","tags":["tools"]}' \
  https://klutt3rbox.ck42x.com/api/v1/containers

Create or update a detailed item

curl -X POST -H "Authorization: Bearer kb_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"containerKey":"garage-shelf","name":"Cordless drill","quantity":1,"brand":"Example","model":"X18","tags":["tool"]}' \
  https://klutt3rbox.ck42x.com/api/v1/inventory

Upload and attach an image

curl -X POST -H "Authorization: Bearer kb_YOUR_KEY" \
  -F "itemId=ITEM_UUID" -F "kind=image" -F "file=@photo.jpg" \
  https://klutt3rbox.ck42x.com/api/v1/media

Connect to trusted AI or automation

Claude / Claude Code

Add your inventory as optional context in Claude's system prompt or fetch it dynamically when a task needs it:

# In your Claude system prompt or CLAUDE.md:
# "My inventory is available at https://klutt3rbox.ck42x.com/api/v1/inventory
#  Use Authorization: Bearer kb_YOUR_KEY to query it."

# Or fetch it in a script:
INVENTORY=$(curl -s -H "Authorization: Bearer kb_YOUR_KEY" \
  "https://klutt3rbox.ck42x.com/api/v1/inventory?format=compact")
echo "Here is my inventory: $INVENTORY" | claude -p "Do I have spare batteries?"

ChatGPT / Custom GPTs

Use the API as a custom action in your GPT. Add an action with the OpenAPI spec:

# In your Custom GPT action configuration:
# Method: GET
# URL: https://klutt3rbox.ck42x.com/api/v1/inventory
# Headers: Authorization: Bearer kb_YOUR_KEY
# Query params: search, container, format, limit

Any AI Tool / Automation

Standard REST API. Use from Python, JavaScript, n8n, Zapier, or any HTTP client:

# Python
import requests
resp = requests.get(
    "https://klutt3rbox.ck42x.com/api/v1/inventory",
    headers={"Authorization": "Bearer kb_YOUR_KEY"},
    params={"format": "compact", "search": "tools"}
)
items = resp.json()

# JavaScript / TypeScript
const resp = await fetch(
  "https://klutt3rbox.ck42x.com/api/v1/inventory?format=compact",
  { headers: { Authorization: "Bearer kb_YOUR_KEY" } }
);
const data = await resp.json();

API Reference

Parameter	Type	Description
id	UUID	Read one item back deterministically after a write
search	string	Search item identity and detail fields; tags and AI keywords match exact elements
container	string	Filter by container key
format	"full" \| "compact"	compact = fewer tokens for LLM context
limit	number	Max results (default 100, max 1000)
offset	number	Pagination offset

Questions? support@ck42x.com