Skip to main content

​
API Reference

The Airstore API is coming soon. Currently, all functionality is available through the CLI.

​
What’s coming

The API will allow you to:
  • Manage sources: Connect and disconnect sources programmatically
  • Create smart folders: Define queries via API
  • Execute tools: Run tools without the CLI
  • Access audit logs: Query logs programmatically
  • Manage permissions: Control access via API

​
Current alternatives

For now, use the CLI for all operations: 
# Authentication
airstore login

# Sources
airstore connect gmail
airstore sources list

# Smart folders
airstore create sources/gmail/my-folder --query "..."

# Tools
~/airstore/tools/github create-issue --repo=acme/api --title="..."

# Logs
airstore logs --format=json

​
Automation

You can automate CLI commands in scripts: 
#!/bin/bash

# Create smart folder
airstore create sources/gmail/daily \
  --query "emails from today"

# Sync
airstore sync sources/gmail/daily

# Process with Claude
cd ~/airstore/sources/gmail/daily
claude "Summarize these emails" --print

​
Stay updated

Watch the GitHub repository for API release announcements: github.com/beam-cloud/airstore