Overview
Ways to reach Era from outside: API keys, webhooks, forms, files, the site and MCP.
Use the HTTP endpoints in this section to read Era from another system, write data into it, or listen to its events. Each page covers one endpoint (or a few that belong together): what it does, how it authenticates, which fields it takes, what it returns and which errors it gives.
Every example uses https://app.getera.io as the address and ERA_API_KEY in place of the key. Never paste a real key into a document, a chat or Git.
Before you start
Authentication
Creating an API key, sending it, and rate limits.
MCP server
The endpoint that connects Claude, ChatGPT or Cursor to Era.
Tables
Read and write records in Era Tables. Needs an API key.
List records
GET — paging, sorting, search and filters.
Create records
POST — one record, or up to 500 at once.
Get a record
GET — every field of one record.
Update a record
PATCH — only the fields you send change.
Delete a record
DELETE — removes the record.
Workflows
Run a deployed workflow from outside and read its history. Needs an API key.
Run a workflow
POST — synchronous, in the background, or streamed.
Background job status
GET — the result of a queued run.
List workflows
GET — the workflows in a workspace.
Get a workflow
GET — details and expected inputs.
Run logs
GET — filtered run history.
Log detail
GET — one run in detail, with its snapshot.
Webhooks
Incoming webhook
An outside system posts an event to Era; workflows start.
Outgoing webhook
Era posts its events to your address, signed.
Forms, files and the site
These endpoints are public: they are the doors visitors use and take no API key.
Submit a form
POST — sends an answer to a published form.
Form QR code
GET — the form's link as an SVG QR code.
Public file
GET — the permanent address of a published file.
Upload link
POST — sends a file through an upload link.
Site catalogue
GET — the products of a published site.
Services and free times
GET — bookable services and open slots.
See also
- API and webhook reference — the wider map of in-app actions and events.
- MCP — guide to connecting AI clients.
- Era CLI — Era from the command line.