Introduction
Learn how to integrate Interna into your application and start building with our platform APIs.
Overview
Interna provides a unified platform for managing identity, access control, and organizational data. Our APIs are designed for developers who need reliable, well-documented interfaces to build secure applications.
Whether you're building a SaaS product, internal tooling, or a customer-facing portal, Interna gives you the building blocks to handle authentication, authorization, and user management without reinventing the wheel.
Key Features
- Multi-tenant architecture — Built-in support for organizations, teams, and role-based access control.
- RESTful APIs — Clean, predictable endpoints following REST conventions with comprehensive error handling.
- SDKs for major languages — Official client libraries for Node.js, Python, Go, and Ruby.
- Webhooks — Real-time event notifications for user lifecycle, permission changes, and more.
- Enterprise SSO — SAML 2.0 and OIDC integration for enterprise customers out of the box.
Architecture
Interna follows a microservices architecture with a unified API gateway. All requests are authenticated at the gateway level before being routed to the appropriate service.
Supported Environments
| Environment | Base URL | Purpose |
|---|---|---|
Production | api.interna.dev | Live production workloads |
Staging | staging-api.interna.dev | Pre-production testing |
Sandbox | sandbox-api.interna.dev | Development and experimentation |
Quick Example
Here's a minimal example showing how to initialize the client and fetch the current user:
import { Interna } from "@interna/sdk";
const client = new Interna({
apiKey: process.env.INTERNA_API_KEY,
environment: "production",
});
const user = await client.users.getCurrent();
console.log(user.email, user.organization.name);Next Steps
- Follow the Quick Start guide to set up your first project.
- Explore the API Reference for detailed endpoint documentation.
- Read about Authentication to understand our security model.
- Check the SDKs & Libraries page for language-specific guides.