Przejdź do treści
Biblioteka skilli
Programowanie · Integracja z narzędziem

inngest-api

/inngest-api

Obsługuje REST API v2 Inngest przez surowy HTTP i OpenAPI: uwierzytelnianie kluczami, bazowe adresy, paginację, ukrywanie sekretów i endpointy, których CLI nie udostępnia.

Repozytorium
inngest-skills ↗
Licencja
Apache-2.0
Ostatnia zmiana repozytorium
28.09.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
2
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
9
Przestarzałość

Brak sygnałów. Repozytorium zmienione 28.09.2026, bez odwołań do wycofanych modeli i API.

Licencja

Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.

Co robi i kiedy

Obsługuje REST API v2 Inngest przez surowy HTTP i OpenAPI: uwierzytelnianie kluczami, bazowe adresy, paginację, ukrywanie sekretów i endpointy, których CLI nie udostępnia.

Oryginalny opis (EN)

Use when the user explicitly asks for the Inngest REST API v2, raw HTTP, OpenAPI, API docs, API authentication, or an endpoint that the Inngest CLI does not expose. Covers api-docs.inngest.com, llms.txt, the OpenAPI v2 spec, Bearer authentication with API keys or signing keys, production and local base URLs, raw curl/fetch requests, request-shape discovery, pagination, secret redaction, and when to prefer the `inngest-api-cli` skill instead.

Jak działa

  1. Prefer CLI First
  2. Docs Lookup
  3. Base URLs
  4. Authentication
  5. Endpoint Discovery
  6. Request Rules
  7. Mutation Safety
  8. Output Handling
Sekcje z nagłówków SKILL.md, w oryginale · 125 linii, 652 słów
Podgląd SKILL.md
---
name: inngest-api
description: >-
  Use when the user explicitly asks for the Inngest REST API v2, raw HTTP,
  OpenAPI, API docs, API authentication, or an endpoint that the Inngest CLI
  does not expose. Covers api-docs.inngest.com, llms.txt, the OpenAPI v2 spec,
  Bearer authentication with API keys or signing keys, production and local
  base URLs, raw curl/fetch requests, request-shape discovery, pagination,
  secret redaction, and when to prefer the `inngest-api-cli` skill instead.
---

# Inngest REST API v2

For Cloud operations with connected MCP tools, use `inngest-cloud` first.
Keep this skill for explicit terminal/HTTP work or a capability missing from
MCP. Do not ask for an API key when OAuth MCP can complete the task.

Use this skill for raw REST API v2 work and API reference lookup. If the task
can be completed through `npx inngest-cli@latest api`, use `inngest-api-cli`
instead; the CLI is safer for agents because it handles target/auth flags and
endpoint command wiring.

## Prefer CLI First

Use `inngest-api-cli` for:

- Run and trace debugging from a run ID or event ID.
- Account, environment, key, webhook, app sync, and function invocation checks.
- Insights table/schema/query workflows.
- Local dev server or Cloud operational checks.

Use raw REST API v2 only when:

- The CLI does not expose the needed endpoint.
- The user explicitly asks for HTTP, curl, fetch, OpenAPI, or API docs.
- You need to inspect request/response schemas before deciding what to do.

## Docs Lookup

When precision matters, fetch current docs instead of guessing:

- API overview: `https://api-docs.inngest.com/`
- Authentication: `https://api-docs.inngest.com/authentication`
- LLM index: `https://api-docs.inngest.com/llms.txt`
- OpenAPI v2 spec: `https://api-docs.inngest.com/api-specs/v2.json`
- Markdown page pattern: add `.md` to a docs URL, for example
  `https://api-docs.inngest.com/v2/runs/GetFunctionTrace.md`
- Endpoint request/response schemas:
  [references/rest-api-v2.md](references/rest-api-v2.md)

If a Markdown page returns an error or omits generated reference details, use
the OpenAPI spec for methods, paths, parameters, request bodies, and schemas.

## Base URLs

- Cloud v2: `https://api.inngest.com/v2`
- Local dev server v2: `http://localhost:8288/api/v2`
- API docs say the dev server may also be reached through the local server
  origin. Confirm the actual dev server port before making local requests.

## Authentication

The REST API uses Bearer token authentication.

- Prefer `INNGEST_API_KEY` for requests from CI, scripts, tools, and agents.
- Signing keys are primarily for apps communicating with Inngest; use them for
  API requests only when that is the available, appropriate credential.
- API keys are for v2 endpoints only.
- Include `X-Inngest-Env` or use an environment-scoped API key when operating
  outside the default production environment.
- Never paste, print, commit, or log API keys, event keys, signing keys,
  webhook URLs, or decrypted secrets.

Example:

```bash
curl -fsSL \
  -H "Authorization: Bearer $INNGEST_API_KEY" \
  -H "X-Inngest-Env: $INNGEST_ENV" \
  https://api.inngest.com/v2/account
```

## Endpoint Discovery

Use the OpenAPI spec as the source of truth:

```bash
curl -fsSL https://api-docs.inngest.com/api-specs/v2.json
```

Current v2 areas include account, environments, keys, webhooks, apps, function
invocation, event-run lookup, function runs, traces, Insights, and partner APIs.
Endpoint coverage can change, so inspect the spec before writing a raw request.

For API-only or access-gated endpoints, such as partner-account endpoints,
confirm the user has the needed access before attempting a call.

## Request Rules

- Derive method, path, query params, headers, and body from OpenAPI.
- Do not invent undocumented request fields.
- Use structured JSON parsing before making decisions from responses.
- Use body files or here-docs for complex JSON instead of shell-escaped one
  liners.
- Add pagination cursors when `page.hasMore` is true and complete results are
  needed.
- Treat missing `data` in list responses as an empty list unless an error is
  present.

## Mutation Safety

Read before write. Confirm target account, environment, resource, and intent
before raw HTTP mutations unless the user's instruction already makes all of
that explicit.

Treat these categories as mutating or side-effecting:

- Creating or patching environments.
- Creating webhooks.
- Syncing apps.
- Invoking functions.
- Partner account creation.
- Broad Insights queries that may be expensive or noisy.

## Output Handling

- Summarize IDs, names, statuses, pagination, and actionable errors.
- Redact token values, webhook URLs, sensitive payload fields, and decrypted
  secrets.
- Do not paste large raw traces, full OpenAPI fragments, or full response
  bodies unless the user asks.
- If auth fails, first verify that a credential is present in the environment;
  then ask the user to provide or rotate `INNGEST_API_KEY` without pasting it
  into chat.
Pliki w paczce (2)
  • SKILL.md 5 KB
  • references/rest-api-v2.md 7 KB

Wersje

W bazie nie ma innych skilli o nazwie inngest-api.

Migawka bazy z 13.11.2026 · wersja paczki 5b202c249ca1 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100inngest-cli
    Instaluje i uruchamia CLI oraz Dev Server Inngest do lokalnego rozwoju i testów, w tym inngest dev, inngest start, Docker Compose, konfigurację MCP i flagi serwera self-hosted.
  • 100inngest-api-cli
    Obsługuje zasoby Inngest z terminala przez npx inngest-cli api: debugowanie przebiegów, ślady funkcji, wywołania funkcji, synchronizacje aplikacji, webhooki, środowiska, klucze i zapytania Insights.
  • 100inngest
    Pomaga budować trwałe przepływy Inngest, zadania w tle, funkcje sterowane zdarzeniami, ponowienia, harmonogramy i procesy rozdzielające pracę.
  • 90inngest
    Pomaga budować w Inngest zadania w tle i przepływy sterowane zdarzeniami z trwałym wykonaniem, bez zarządzania kolejkami i workerami.
  • 100common-api-design
    Stosuje konwencje REST API: semantykę HTTP, kody statusu, wersjonowanie, paginację i standardy OpenAPI, niezależnie od frameworka.
  • 100inngest-nextjs-patterns
    Wdraża funkcje zdarzeniowe Inngest w Next.js (App Router): klient, route handler /api/inngest, typowane zdarzenia ze schematami Zod, funkcje cron i orkiestratory fan-out.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.