REST · OpenAPI 3.0.3 · v1.0.0

The ELECTE platform, programmable.

Authenticate with JWT, manage projects over clean REST, and subscribe to real-time webhooks — the core surface documented in OpenAPI, ready for the tools you already use.

$ curl https://api.electe.net/v1/workspaces   -H "Authorization: Bearer <API key>"
HTTP/2 200 OK
X-RateLimit-Remaining: 59
{ "data": [ { "id": "…", "name": "ELECTE Srl", "role": "owner" } ],
  "page": { "limit": 25, "offset": 0 } }
1,000 req/h
documented limit, authenticated
100 req/h
documented limit, per IP
4 events
real-time webhook triggers
OpenAPI 3.0
machine-readable spec

Capabilities

Everything the platform does, over HTTP

Six building blocks, no filler — each one live in the API today.

JWT authentication

Bearer-token auth with signup and login endpoints. Sessions are issued per user and verified on every request.

Real-time webhooks

Register a URL, choose your events — user and project lifecycle changes are delivered as they happen.

Project management

Full CRUD on projects — create, list with pagination, update and delete — scoped to the authenticated user.

Rate limiting

Rate limiting today is a per-instance burst brake, not an account quota — responses say so with X-RateLimit-Scope: instance. Durable per-key limits are specified and not yet deployed.

OpenAPI specification

The core surface in one machine-readable file — generate clients, mock servers and tests from the same source.

Plain REST

Predictable URLs, JSON in and out, standard status codes. If you can send an HTTP request, you can integrate.

Surface area

The platform's own resources, read-only

A deliberately small API you can hold in your head. Every route is a GET, authenticated with a platform API key and scoped to the workspaces that key can reach.

/v1/me GET the calling key: its user, its scopes, the workspaces it can reach
/v1/workspaces GET your workspaces, then /{id}, /{id}/data-sources, /{id}/usage, /{id}/webhooks
/v1/reports GET a workspace's generated reports, one report's content, and its generation stage

Integrations

Meets your stack where it is

Zapier Make n8n Postman Webhook.site

Anything that speaks HTTP and JSON works — these are the ones the collection and examples are built for.