# 633Logs

> 633Logs is the Debug layer of the 633 Labs platform: AI-first exception intelligence and structured logging.

## API for AI agents

- OpenAPI spec: https://logs.633labs.com/api/openapi.yaml
- API catalog: https://logs.633labs.com/.well-known/api-catalog
- Health: https://logs.633labs.com/api/health

## Quick start for automation

1. **Sign up** at https://633labs.com (core identity) and subscribe to 633Logs (paid plan required for org API keys).
2. **Create an API key** via dashboard or `POST /api/api-keys` (JWT): returns `lgk_...` prefix key once.
3. **Register a webhook** via `POST /api/webhooks` with events like `exception.created,exception.occurred`.
4. **Ingest from apps** using project `client_key` + HMAC (`POST /api/ingest/exception`).
5. **On webhook**, use included `api` paths with your API key to fetch full exception details and trigger `POST /api/exceptions/{id}/analyze`.

## Authentication

| Method | Header | Use case |
|--------|--------|----------|
| Org API key | `X-API-Key: lgk_...` | Read/query API, AI triage (paid plan) |
| User JWT | `Authorization: Bearer <token>` | Dashboard parity, key/webhook management |
| SDK HMAC | `X-Client-Key` + `X-Timestamp` + `X-Signature` | Exception/log ingest from applications |

Free-plan orgs receive HTTP 402 on API key requests.

## Webhook events

- `exception.created` — new exception group first seen
- `exception.occurred` — every ingested exception (includes `is_new` flag)
- `log.critical` — critical/alert/emergency log ingested
- `alert.fired` — notification alert triggered

Verify payloads with `X-633Logs-Signature: sha256=<hmac>` using your webhook secret.

## Key endpoints

- `GET /api/exceptions` — list exception groups
- `GET /api/exceptions/{id}` — full detail + AI summary
- `GET /api/exceptions/{id}/occurrences` — stack traces and metadata
- `GET /api/exceptions/{id}/related-logs` — correlated logs
- `POST /api/exceptions/{id}/analyze` — AI root-cause analysis
- `GET /api/logs`, `GET /api/logs/tail` — structured logs
- `GET /api/search?q=` — cross-resource search
- `POST /api/triage/chat` — conversational incident triage

## SDK ingest

```
POST /api/ingest/exception
X-Client-Key: <project client_key>
X-Timestamp: <unix seconds>
X-Signature: HMAC-SHA256(timestamp + "." + body, client_secret) as hex
```

## Pages

- [Home](https://logs.633labs.com/): Product overview
- [Why Logs](https://logs.633labs.com/why-logs): Comparison with Sentry, Rollbar, and Bugsnag
- [Docs](https://logs.633labs.com/docs): Human documentation
- [Blog](https://logs.633labs.com/blog): Product news

## Related products

Part of [633 Labs](https://633labs.com): 633Page (build), 633Ops (deploy), 633Pulse (monitor).