School management API for developers Everything Edena does, from your code

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.

Install the CLI
$ 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

Four ways to build on Edena

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.

REST API

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.

Ready for production from the first request

What you expect from a serious API, with its behaviour written down in the reference.

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-…

Errors with a stable key

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"

Limits you can read

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

A public OpenAPI reference

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

A real sandbox

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_…

You decide who writes to families

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

A trail for every request

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-…

A prompt per category

Copy a category's prompt from the docs or run edena prompt: your agent builds the integration with the exact types.

› edena prompt invoices

MCP connector Edena in Claude and ChatGPT

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.

Works in
  • Claude
  • ChatGPT
  • Claude Code
  • Codex
  • Gemini CLI
  • GitHub Copilot
  • Cursor
  • Any remote MCP client
  1. How many students in Year 3B were absent yesterday?
  2. 2 of the 24 students in Year 3B were absent yesterday. The family already justified one of the absences from the app.
  3. Invite their families to a meeting on Thursday at 5 pm.
  4. Done. The meeting is now on Year 3B's calendar.

Connected in a minute

  1. 1

    Add the address

    In your assistant, as a custom connector. In Claude it is under Settings, Connectors.

  2. 2

    Approve access in Edena

    You choose the school and whether the assistant only reads or may also make changes.

  3. 3

    Ask in your own language

    It finds the operation, runs it as you and sums up the answer. Before any change it asks you to confirm.

Six tools

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.

What an assistant never does

Even when the person may do it in Edena.

  • Invoices and money stay in Edena

    Issuing or cancelling invoices, payments, refunds, wallets and direct debits are always done in Edena.

  • So do permissions and settings

    Who may do what, the team and the school's settings are never changed from an assistant.

  • Sensitive data, hidden

    Bank details, identity documents, health data and credentials reach it hidden.

  • The school decides

    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

How your development team gets in

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.

Invite whoever builds

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?

Create a development organization

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.

Create a developer account

Developer questions

What people usually ask when they integrate Edena for the first time.

What can an API key do?
It acts with the role it was created with, admin or manager (with its subrole, if any), and reaches exactly what a person with that role reaches. If it lacks a permission, the API answers 403. An organization can hold up to 25 working keys, and each one is revoked in seconds from the console.
Does my school need to use Edena to use the API?
No. If your school already uses Edena, the console is under Developers, in the app's menu. If you only want the API for your own software, create a development organization: it has every module through the API, the console and the sandbox, with a 30-day trial and no card.
Can I test without touching real data?
Yes. From Environment you create a sandbox: an empty copy of your school with keys of its own (edn_test_). No emails or notifications go to families from it, nothing is sent to VeriFactu in production and no cards are charged. You can reset it whenever you like.
How does my system hear about changes?
Through webhooks: every change in Edena (a new student, an invoice collected, an attendance mark) reaches your endpoint as a POST signed with HMAC-SHA256, and is retried for about three days if it does not answer. GET /webhook-events lists the last 30 days of events, and locally edena listen forwards them with no public address.
Can my app act as each family?
Yes, with end-user tokens. Your server asks for them with an admin key and hands them to the app, which then reaches what that family reaches in Edena's apps: their children, their invoices, their announcements and their calendar. If the family has no Edena account, one is made for your app alone. A key sent from a browser gets a 403.
What does the connector for Claude and ChatGPT do?
It lets each member of staff use Edena from their AI assistant, with their account and their permissions. It reads what the person can see and, if they allow it, prepares changes that only happen once they confirm them. It never issues invoices, moves money or changes permissions or settings, and it receives no bank, identity or health data.
How is Ena different from the connector?
Ena is Edena's AI: she lives inside the web app and the mobile app, with the school's context. The connector brings Edena to the assistant each person already uses, such as Claude or ChatGPT. Either way, each person's permissions apply and changes are confirmed before they happen.
Who can get into the developer console?
The school's admins and the people you invite to the development team, as a development admin or as a developer. Someone who is only a developer gets into the console, never into the school's data.
What limits does the API have?
300 requests a minute per key and 1,200 across all of the organization's keys. With end-user tokens, 300 per person and 6,000 across all of an app's people. Every response says how much room is left, and past it the API answers 429 with Retry-After.

The office closes the month without chasing families

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.

Let's talk