Getting started
The Softwerk Gateway exposes the Softwerk LLM Framework over a REST API. All domain endpoints live under /api.
Base URL
| Environment | URL |
|---|---|
| Production | https://gateway.softwerk.se |
| Local development | http://localhost:8000 |
Prerequisites
You need a customer API key. Every request must include it in the x-api-key header. See Authentication for details.
Your first request
Verify your key and inspect your account:
curl -s https://gateway.softwerk.se/api/account \
-H "x-api-key: YOUR_API_KEY"
A successful response includes your customer_id, permitted providers, and billing settings.
Next
- Core concepts — agents, conversations, memory, vector databases
- API Reference — full endpoint documentation
Local development
When running the gateway locally with uv run run-api, use http://localhost:8000 as the base URL. Interactive Swagger UI is available at /swagger; the documentation site is served at /docs when built.