Inngest Skill
Base event ingestion URL: https://inn.gs/e/<INNGEST_EVENT_KEY>
Management API base: https://api.inngest.com/v1
Auth
# 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:
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:
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:
curl -H "Authorization: Bearer $INNGEST_SIGNING_KEY" \
"https://api.inngest.com/v1/runs?limit=20&status=running"
Get a specific run:
curl -H "Authorization: Bearer $INNGEST_SIGNING_KEY" \
"https://api.inngest.com/v1/runs/$RUN_ID"
Cancel a function run:
curl -X DELETE \
-H "Authorization: Bearer $INNGEST_SIGNING_KEY" \
"https://api.inngest.com/v1/runs/$RUN_ID"
List all registered apps:
curl -H "Authorization: Bearer $INNGEST_SIGNING_KEY" \
"https://api.inngest.com/v1/apps"
Replay a failed run:
curl -X POST \
-H "Authorization: Bearer $INNGEST_SIGNING_KEY" \
"https://api.inngest.com/v1/runs/$RUN_ID/replay"
Tips
- Event names follow
domain/noun.verbconvention (e.g.app/user.created) - Batch up to 512 events per POST to reduce HTTP overhead
- The
user.idfield enables per-user throttle and concurrency controls - Filter runs by
status(running, completed, failed, cancelled) to keep responses lean
