Aegis Developer Portal

Developer Search

Press ⌘K or Ctrl+K to jump through guides and public API docs for user-owned master key and scoped credential flows.

SDKs

SDK Surface and Language Clients

SDK contracts are generated from protobuf + Connect definitions. Keep SDK upgrades synchronized with release notes and changelog entries.

Go

Server + client stubs are generated in `services/api/gen`. Prefer integration tests for policy-sensitive flows.

go run ./services/api/cmd/server
go test ./services/api/...

TypeScript

Web client and docs explorer consume generated artifacts and OpenAPI metadata in lockstep.

pnpm proto:gen
pnpm --filter @aegis/web lint

Bash / CLI

Use direct HTTP calls for diagnostics and smoke checks in CI scripts.

curl -X POST "$API_BASE/aegis.v1.BrokerService/MintUserApiToken" \
  -H "Authorization: Bearer $FIREBASE_ID_TOKEN" \
  -H "Content-Type: application/json" \
  -d @mint-user-token.json

Release Discipline

Pin generated SDK revisions to tagged releases.
Run compatibility tests on every API schema update.
Publish migration notes for removed or renamed fields.

Open Versioning Policy