Skip to main content

Platform API

The Platform API is the central API for Alien Intelligence. It handles authentication, organization management, dataset catalog, cluster orchestration, workflow execution, and billing.

Base URL​

https://api.alien.club

Authentication​

API Tokens (Programmatic Access)​

For scripts, SDKs, and integrations, use an API token created from the Keys section in the dashboard (see Manage Your Organization).

curl -H "Authorization: Bearer oat_YOUR_API_TOKEN" \
  https://api.alien.club/datasets

OAuth JWT (Web Sessions)​

The web interface authenticates automatically via OAuth2 + OIDC. You don't need to manage JWT tokens manually.

Dual-Guard System​

The backend accepts both methods — API token first, then OAuth JWT. Both produce the same authorization context.

Cluster Proxy​

The Platform API includes a proxy that forwards requests to data clusters:

ANY /clusters/{cluster_id}/proxy/*

This is the primary way to access the Data API for Alien Hosted deployments. The proxy authenticates, authorizes, and logs every request.

curl -X POST "https://api.alien.club/clusters/5/proxy/api/v1/search" \
  -H "Authorization: Bearer oat_YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"query": "machine learning", "limit": 10}'

Full API Reference​

Coming Soon

The full Platform API reference with interactive endpoint documentation is being prepared. A curated selection of public-facing endpoints will be published here.

In the meantime, the Data API Reference provides complete documentation for data cluster endpoints, and the SDK Reference covers client library usage.

Next Steps​