Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Inngest Runs API

Fetch the status, jobs, and trace trees of function runs.

Inngest Runs API is one of 8 APIs that Inngest publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 9 JSON Schema definitions.

Tagged areas include Runs. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, a getting-started guide, a JSON-LD context, rate-limit docs, and 9 JSON Schemas.

This API exposes 5 operations across 5 paths, and defines 5 schemas. It is described by OpenAPI 3.0.3, at version 2026-05.

Requests are made against 5 base URLs: https://api.inngest.com, https://api.inngest.com/v2, https://inn.gs, http://localhost:8288, http://localhost:8288/api/v2.

5 operations 5 paths 5 schemas 4 GET1 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.3
API Version
2026-05
Base URL
https://api.inngest.com
Authentication
HTTP Bearer
Contact
Resource Areas
1

Authentication & Security 1

Inngest Runs API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (signing-key) (bearerAuth).

Paths & Operations 5

Across 5 paths, the API surfaces 5 operations — 4 GET, 1 POST. Each is listed below with its method, path, parameters, and response codes.

Runs 5

Fetch the status, jobs, and trace trees of function runs.

GET
/v1/runs/{runId}
Get Function Run Status
getRun 1 param → 200404
GET
/v1/runs/{runId}/jobs
List The Jobs (Steps) For A Run
listRunJobs 1 param → 200
POST
/v1/runs/{runId}/cancel
Cancel A Function Run
cancelRun 1 param → 200404
GET
/v2/runs/{runId}
Get Function Run (v2)
v2GetFunctionRun 1 param → 200
GET
/v2/runs/{runId}/trace
Get Function Trace
v2GetFunctionTrace 1 param → 200

Schemas 5

The contract defines 5 schemas that model the data the API accepts and returns. The most detailed are V2TraceSpan (9 properties), V2FunctionRun (8 properties), Run (7 properties), Job (6 properties). Each schema is shown below with its type and property counts.

Run
object
7 properties
V2FunctionRun
object
8 properties
V2TraceSpan
object
9 properties
V2FunctionTrace
object
2 properties
Job
object
6 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

inngest-runs-api-openapi.yml Raw ↑

Other APIs Inngest publishes across the network.

Inngest Account API
Inngest Apps API
Inngest Environments API
Inngest Events API
Inngest Functions API
Inngest Keys API
Inngest Webhooks API