Managed APIs

Managed APIs are outside services that Ordalie can call on your behalf, using credentials we keep on the server. They let the assistant and your workflows draw on specialised providers without the provider keys ever being handed to the scripts that run. You will find them in your personal Settings, under the Integrations tab, in a section titled Managed APIs.

The services available today

Three providers are available. DeepL handles translation and is what the Document translation workflow uses to produce a translated copy of a file while leaving the original untouched. Pappers provides official data on French companies, such as directors, filings, accounts, and registry documents, which a task can pull in when it needs them. Aviation Edge gives access to aviation data; it is meant for agents and any custom workflows that query that data, rather than a ready-made workflow shipped with Ordalie.

How the keys are handled

Each service runs in one of two ways. Most are managed by Ordalie, shown as Managed by Ordalie: the key lives on our server, and all you do is turn the service on or off. DeepL and Pappers work this way and are on by default, so you can use them straight away and switch them off if you prefer. Aviation Edge instead uses an Organization key: an administrator sets it up once for the whole organization, and once it is configured everyone can use the service without ever seeing the key. None of the current services ask you to enter a personal key of your own.

Turning them on and off

You manage these services from the Integrations tab in your Settings. Each available service shows a toggle that reads Enabled or Disabled. Ordalie-managed services like DeepL and Pappers are enabled to begin with and can be turned off at any time. An organization-key service like Aviation Edge depends on an administrator having configured its key, and whether you can use it may also depend on your plan and permissions.

Whichever way a service is set up, the provider keys are never shown to the scripts that run or to the assistant. Every call goes through Ordalie's server, where access rules, quotas, request checks, and caching are applied. Depending on the provider and how your organization is set up, a service may be switched off, limited, or kept to certain workflows.

If something is not working

If a workflow that relies on a managed API fails or is unavailable, check that the service is enabled in Settings under Integrations, that an organization-key service has its key in place, and that the provider is not temporarily down or rate-limited.