Skip to content

api-evangelist/trigger-dev

Repository files navigation

Trigger.dev

Trigger.dev is an open source platform for building and deploying fully-managed AI agents and background workflows in TypeScript. It provides durable task execution without timeout constraints, automatic retries, scheduled cron tasks, queues with concurrency controls, real-time observability, React hooks for streaming run status, human-in-the-loop waitpoints, batch triggering, and a comprehensive Management API. Cloud-hosted at cloud.trigger.dev and self-hostable via Docker or Fly.io.

"Trigger.dev is the platform for building AI workflows in TypeScript." — trigger.dev

APIs.yml: View APIs.yml

Timestamps

  • Created: 2026-03-27
  • Modified: 2026-05-22

APIs

Trigger.dev Management API

REST endpoints (base URL https://api.trigger.dev) for managing workflow runs, tasks, schedules, deployments, queues, environment variables, batches, waitpoints, and TRQL query/dashboards. Authenticated with a bearer secret API key (tr_dev_*, tr_prod_*, tr_stg_*) or personal access token (tr_pat_*).

Human URL: https://trigger.dev/docs/management/overview

Tags: Workflow Automation, Background Jobs, Task Management, Scheduling, Deployments, Queue Management, Waitpoints, Batches, Environment Variables, Query

Properties:

Trigger.dev Realtime API

Live streaming updates and React hooks (useRealtimeRun, useRealtimeRunsWithTag, useRealtimeBatch, useRealtimeStream, useWaitToken, trigger-plus-subscribe hooks) plus backend subscribeToRun / subscribeToRunsWithTag / subscribeToBatch methods. Powers progress UIs, AI streaming output, and human-in-the-loop interfaces.

Human URL: https://trigger.dev/docs/realtime/overview

Tags: Realtime, Streaming, React, WebSockets, AI Streaming, Frontend

OpenAPI Specifications

Specification Description
Trigger.dev Management API Full Management API: tasks, runs (list/retrieve/cancel/replay/reschedule/tags/events/result/trace/metadata), schedules, deployments, queues, env vars, batches, waitpoints (incl. list + callback), and TRQL query.

Spectral Rules

Ruleset Description
Trigger.dev Rules Spectral ruleset enforcing Trigger.dev API conventions (camelCase operationIds, versioned paths, bearer auth, required path params, run_ prefix, RunStatus enum).

Naftiko Capabilities

Capability Description
capabilities/management-tasks.yaml Trigger and batch-trigger task runs (2 operations).
capabilities/management-runs.yaml List, retrieve, cancel, replay, reschedule, tag, and inspect events/result/trace/metadata for runs (10 operations).
capabilities/management-schedules.yaml Create, list, retrieve, update, delete, activate, deactivate schedules + timezones.
capabilities/management-deployments.yaml List, retrieve, get-latest, promote deployments.
capabilities/management-queues.yaml List, retrieve, pause, resume, override and reset queue concurrency.
capabilities/management-environment-variables.yaml CRUD plus bulk import for environment variables.
capabilities/management-batches.yaml Create and retrieve large-scale batches.
capabilities/management-waitpoints.yaml Create, retrieve, complete, list waitpoint tokens.
capabilities/management-query.yaml Execute TRQL queries for analytics and dashboards.

JSON Schema

Schema Description
json-schema/trigger-dev-run-schema.json JSON Schema for Trigger.dev run entities.
json-schema/trigger-dev-schedule-schema.json JSON Schema for Trigger.dev schedule entities.
json-schema/trigger-dev-waitpoint-token-schema.json JSON Schema for Trigger.dev waitpoint tokens.

JSON Structure

Structure Description
json-structure/trigger-dev-run-structure.json Structure documentation for Trigger.dev runs.

JSON-LD Context

Context Description
json-ld/trigger-dev-context.jsonld JSON-LD context for Trigger.dev workflow, runtime, query, and observability entities.

Examples

Example Description
examples/trigger-dev-trigger-task-example.json Trigger a task with payload and options.
examples/trigger-dev-list-runs-example.json List runs with status and tag filtering.
examples/trigger-dev-create-schedule-example.json Create a cron schedule.
examples/trigger-dev-create-waitpoint-example.json Create a waitpoint token for a human-in-the-loop step.
examples/trigger-dev-execute-query-example.json Execute a TRQL query grouped by run status.
examples/trigger-dev-retrieve-run-events-example.json Retrieve OpenTelemetry-style events for a run.

Vocabulary

File Description
vocabulary/trigger-dev-vocabulary.yml Domain vocabulary covering task execution, run lifecycle, scheduling, queues, deployments, workflow patterns, authentication, realtime/streaming, and query/observability.

Plans, Rate Limits, and FinOps

File Description
plans/trigger-dev-plans-pricing.yml API Commons Plans 0.1 mapping for Free ($0), Hobby ($10/mo), Pro ($50/mo), and Enterprise tiers; per-second compute pricing and $0.000025/run invocation.
rate-limits/trigger-dev-rate-limits.yml Per-tier and global limits: 1500 req/min API rate, concurrency, schedules, realtime connections, batch buckets, payload/output caps, queue depth ceilings.
finops/trigger-dev-finops.yml FinOps Framework / FOCUS-aligned billing model with run, compute, realtime, schedule, and egress meters.

GitHub

Trigger.dev's GitHub organization (triggerdotdev) hosts 85+ repositories. Highlights:

Common Links

Maintainers

About

Trigger.dev is an open source background jobs and workflow automation platform for TypeScript developers. It enables building and deploying fully-managed AI agents and background workflows with real-time observability, scheduled tasks, durable execution, and an extensive management API.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors