DatasheetDoc. RLY-DS-121Rev 1.2.1 · 2026-06-30 Latest: v1.2.1
RelayRLY-1

Rev 1.2.1 in production

Relay, revision by revision.

The working record of Relay, the platform that deploys an API from a folder of files. Every change that shipped, and the docs to wire it up.

Read v1.2.1 notesQuickstart in 60 s
INRELEASEPUBLISHEDK1V+COMNOD1OUTRLY-1 · REV ACONTACT CLOSED
Figure 1. Simplified schematic: a release energizes K1, the contact closes, and the notes reach your inbox.

1 Features

  • Folder-shaped routingA file in routes/ is an endpoint. No router to configure.
  • One-command deploysrelay deploy swaps traffic atomically; rollback in about a second.
  • Watch-mode dev loopRoutes reload on save in under 300 ms, with request replay.
  • Signed webhooksHMAC-signed events with retries and a delivery inspector.
  • Staging and productionPer-environment secrets and one-step promotion.
  • Semver from 1.0No breaking changes outside majors, codemods where possible.

2 Applications

  • Internal APIs and admin tools
  • Webhook receivers
  • Cron jobs and glue code
  • Prototypes that ship

3 Description

Relay turns a directory of TypeScript handlers into a deployed HTTP API, with logs, metrics, secrets and environments built in. It has been stable since 1.0 and keeps a semver promise; this sheet tracks each revision since the public beta.

3.1 Electrical characteristics

Electrical characteristics of Relay
ParameterSymbolConditionsMinTypMaxUnitRef
Sign-up to first deployed routeMedian, new account · v0.7.0tFIRSTMedian, new account—58—sv0.7.0
Route reload on saverelay dev --watch, median · v1.1.0tRELOADrelay dev --watch, median——300msv1.1.0
Rollback to previous buildrelay rollback · § 1.3tRBrelay rollback—≈1—s§ 1.3
Handler executionPer request, then route_timeout · § 3.2tEXECPer request, then route_timeout——30s§ 3.2
Webhook acknowledge windowAny 2xx response · § 2.2tACKAny 2xx response——10s§ 2.2
Webhook delivery attemptsExponential backoff, jitter, 24 h · v1.2.0NRETRYExponential backoff, jitter, 24 h1—8—v1.2.0
Secret rotation overlapOld and new secret both valid · v1.2.0tROTOld and new secret both valid—24—hv1.2.0
Free-tier requestsPer month; overage pauses, never bills · v0.7.0RFREEPer month; overage pauses, never bills——100kreqv0.7.0

Note 1. Values are quoted from the release notes and docs linked in the Ref column. A dash means the parameter is not specified at that limit.

4Revision history

All 7 revisions →
RevDateChangeClass
1.2.1Jun 30, 2026Patch: webhook redelivery and CLI fixesFixes a redelivery loop for endpoints returning 3xx and restores relay dev on Node 24.Fixed1.2.0Jun 24, 2026Webhooks are generally availableOutbound webhooks leave beta with signed payloads, automatic retries, and a delivery inspector in the dashboard.AddedImproved1.1.0May 28, 2026Watch mode for the CLIrelay dev --watch reloads routes on save, plus request replay and faster cold starts.AddedImprovedFixed1.0.0Apr 30, 2026Relay 1.0Relay is stable. A finished core API, a public roadmap, and a semver promise from here forward.AddedBreaking

5Pin configuration and functions

Documentation →

Each pin is a page of the docs. Start at pin 1 and work around the package.

INTRO1INSTALL2QSTART3CONFIG4
8REVS7ERR6CLI5HOOKS
PinNameTypeDescription
1INTROIWhat Relay is, what it is for, and how the pieces fit together.2INSTALLIInstall the Relay CLI and authenticate your machine.3QSTARTIFrom nothing to a deployed API endpoint in about a minute.4CONFIGI/OEverything relay.toml can do: routes, environments, secrets, and webhooks.5HOOKSI/OReceive signed events from Relay and verify them in one line.6CLIOEvery relay command, its flags, and what it does.7ERROWhat Relay error codes mean and how to fix each one.8REVSOEvery release, version by version.

6Release notifications