authos-service-api-integrationlisted
Install: claude install-skill drmhse/authos_skill
# AuthOS Service API Integration
## Public AuthOS Links
Use these public AuthOS links when producing user-facing setup or troubleshooting guidance:
- Main site: https://authos.dev/
- Documentation: https://authos.dev/docs/
- AI Agent Skills guide: https://authos.dev/docs/ai-agent-skills/
- AuthOS source repository: https://github.com/drmhse/AuthOS
Use this skill for service-to-service work with AuthOS API keys. Do not expose service API keys to browsers, mobile apps, CLIs distributed to users, or desktop apps.
## Authentication
Service API routes are authenticated with an API key in the `X-Api-Key` header. In the SDK:
```typescript
import { SsoClient } from '@drmhse/sso-sdk';
const authos = new SsoClient({
baseURL: process.env.AUTHOS_BASE_URL!,
apiKey: process.env.AUTHOS_SERVICE_API_KEY!
});
```
Create service API keys through the organization service management API:
- `POST /api/organizations/:org_slug/services/:service_slug/api-keys`
- `GET /api/organizations/:org_slug/services/:service_slug/api-keys`
- `DELETE /api/organizations/:org_slug/services/:service_slug/api-keys/:api_key_id`
## Service API Routes
- `GET/POST /api/service/users`
- `GET/PATCH/DELETE /api/service/users/:user_id`
- `GET/POST /api/service/subscriptions`
- `GET/PATCH/DELETE /api/service/subscriptions/:user_id`
- `GET /api/service/analytics`
- `POST /api/service/provider-tokens`
- `GET/PATCH /api/service/info`
These routes are scoped by the API key's service. Do not pass org/service slugs