Retries without duplicates
Send each write with an Idempotency-Key and repeat it for 24 hours: it answers what it answered the first time and never runs twice.
› Idempotency-Key: 5f0c2e9a-… Over 800 operations, an event for every change, a CLI for you and your AI agent, and a connector for Claude and ChatGPT. Every key acts with one of the school's roles and reaches exactly what a person with that role reaches.
$ npm install -g @edena-solutions/cli 30-day trial, no credit card.
Does your school already use Edena? The console is under Developers, in the app's menu.
edena login · Authorize the Edena CLI · Sandbox · edena students list · edena skill install
The same API sits under all of them. Call it from your server, hear about every change as it happens, work from the terminal or let your app speak as each family.
Students, invoices, attendance, CRM, timetables: every screen of Edena has its operation. Send the key in the Authorization header and get JSON back, typed in the OpenAPI reference.
What you expect from a serious API, with its behaviour written down in the reference.
Send each write with an Idempotency-Key and repeat it for 24 hours: it answers what it answered the first time and never runs twice.
› Idempotency-Key: 5f0c2e9a-… Every error answers with the same body. Decide on key, which never changes, and keep the requestId. Over 400 keys are documented.
› "key": "auth.api_key_in_browser" 300 requests a minute per key and 1,200 across all of the organization's keys. Every response says how much room is left; past it, 429 with Retry-After.
› X-RateLimit-Remaining: 287 Every operation with what it takes, what it returns and its errors, in English, Spanish and Catalan. The CLI and the agents read it so they invent nothing.
› GET /openapi.json?lang=en An empty copy of your school with keys of its own. Nothing leaves it: no emails, no notifications, no VeriFactu in production, no card payments.
› edn_test_… If your app talks to families, turn off Edena's emails and notifications to them. Staff and the development team keep getting theirs.
› 409 organization.family_messaging_off The console keeps 30 days of requests with their requestId, the p95 latency, and every webhook delivery with what your system answered.
› X-Request-Id: 0190f4d2-… Copy a category's prompt from the docs or run edena prompt: your agent builds the integration with the exact types.
› edena prompt invoices Each member of staff connects their assistant with their own account and asks about the school in their own language. The assistant sees and does what that person can in Edena, never more.
In your assistant, as a custom connector. In Claude it is under Settings, Connectors.
You choose the school and whether the assistant only reads or may also make changes.
It finds the operation, runs it as you and sums up the answer. Before any change it asks you to confirm.
The ones that change data only appear if the person allowed it when connecting.
whoami Read Who it acts as: person, school, roles and whether it may change data. search_operations Read Finds the API's operations in plain words. describe_operation Read Describes an operation with its parameters and types. read_operation Read Runs a read as the person. prepare_change Change Prepares a change without making it and shows what it will do. apply_change Change Makes the confirmed change, once. Even when the person may do it in Edena.
Issuing or cancelling invoices, payments, refunds, wallets and direct debits are always done in Edena.
Who may do what, the team and the school's settings are never changed from an assistant.
Bank details, identity documents, health data and credentials reach it hidden.
An admin chooses which roles may connect an assistant and can disconnect all of them at once.
Up to 120 calls a minute per person and 1,200 per school. What the assistant reads is processed by its provider, under the person's account.
What about Ena? Ena is the AI that already lives inside Edena, on the web and in the app. The connector is for anyone who would rather work from their own assistant. Meet Ena
Whoever builds with you has their own account and their own console, without seeing the school's data. Four steps take them to their first request.
In Developers, Team. A development admin creates keys and invites; a developer reads the docs, the requests and the usage. The school's admins are already on the team.
Only need the API?
Every module through the API for your own software, with the console, the sandbox and the keys, without the management suite. 30-day trial, no card.
What people usually ask when they integrate Edena for the first time.
Invoices go out with Verifactu, attendance is recorded and each family sees it in the app. Seeing it with a school like yours takes 15 minutes.