Inngest
Manage Inngest serverless background jobs and event-driven workflows via REST API. Use when asked to send events, trigger functions, list runs, cancel jobs, or inspect workflow history. Requires INNGEST_EVENT_KEY and INNGEST_SIGNING_KEY env vars.
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
Related skills
- Downloads
- 812All time
- Security audit
- Pass
- Last updated
- 6mo ago
- Current version
- v1.0.0
- License
- MIT-0
