inngest
# Inngest Skill
Base event ingestion URL: `https://inn.gs/e/<INNGEST_EVENT_KEY>`
Management API base: `https://api.inngest.com/v1`
## Auth
```bash
# Send an event (key in URL)
curl -X POST "https://inn.gs/e/$INNGEST_EVENT_KEY" \
-H "Content-Type: application/json" \
-d '{"name":"app/user.signup","data":{"userId":"123"}}'
# Management API
curl -H "Authorization: Bearer $INNGEST_SIGNING_KEY" \
https://api.inngest.com/v1/runs
```
## Common Operations
**Send a single event:**
```bash
curl -X POST "https://inn.gs/e/$INNGEST_EVENT_KEY" \
-H "Content-Type: application/json" \
-d '{"name":"app/order.created","data":{"orderId":"ord_123","total":49.99},"user":{"id":"usr_456"}}'
```
**Send a batch of events:**
```bash
curl -X POST "https://inn.gs/e/$INNGEST_EVENT_KEY" \
-H "Content-Type: application/json" \
-d '[{"name":"app/email.sent","data":{"to":"a@example.com"}},{"name":"app/email.sent","data":{"to":"b@example.com"}}]'
```
**List function runs:**
```bash
curl -H "Authorization: Bearer $INNGEST_SIGNING_KEY" \
"https://api.inngest.com/v1/runs?limit=20&status=running"
```
**Get a specific run:**
```bash
curl -H "Authorization: Bearer $INNGEST_SIGNING_KEY" \
"https://api.inngest.com/v1/runs/$RUN_ID"
```
**Cancel a function run:**
```bash
curl -X DELETE \
-H "Authorization: Bearer $INNGEST_SIGNING_KEY" \
"https://api.inngest.com/v1/runs/$RUN_ID"
```
**List all registered apps:**
```bash
curl -H "Authorization: Bearer $INNGEST_SIGNING_KEY" \
"https://api.inngest.com/v1/apps"
```
**Replay a failed run:**
```bash
curl -X POST \
-H "Authorization: Bearer $INNGEST_SIGNING_KEY" \
"https://api.inngest.com/v1/runs/$RUN_ID/replay"
```
## Tips
- Event names follow `domain/noun.verb` convention (e.g. `app/user.created`)
- Batch up to 512 events per POST to reduce HTTP overhead
- The `user.id` field enables per-user throttle and concurrency controls
- Filter runs by `status` (running, completed, failed, cancelled) to keep responses lean
标签
skill
ai
