Managed APIs

Managed APIs are external services that Ordalie can call through server-managed credentials. They let the assistant and workflows use specialized providers without exposing API keys to executed scripts.

Available managed APIs

• DeepL: used for document translation workflows and other translation tasks when enabled.
• Pappers: used to retrieve official information about French companies where the feature is available.
• Aviation Edge: used by organizations that enable aviation-data workflows or agents and configure an organization key.

Credential modes

Ordalie distinguishes several access modes depending on the provider and organization configuration.

• Managed by Ordalie: the provider key is operated by Ordalie. The user can enable or disable usage when their account has access.
• Personal key: the user provides their own provider key when this mode is available.
• Organization key: an administrator configures the key at organization level. Other members can use the API when enabled, without seeing the key.

Who can enable them

Managed APIs are controlled from Settings > Integrations. Depending on the provider, activation may depend on your plan, organization, and administrator permissions. Organization-key APIs are configured by administrators because usage may have cost, quota, and compliance implications.

Where they are used

The Document Translation workflow can use DeepL to create a translated copy while keeping the original document unchanged. Company-information lookups can use Pappers to retrieve official company data when relevant to the task. Aviation Edge can be exposed to authorized agents and workflows to query aviation data through an organization-managed key.

Security and limits

Provider keys are never passed to scripts or the agent runtime. Calls go through the Ordalie server, with access policies, quotas, endpoint validation, and caching where relevant. Depending on the provider and organization configuration, usage may be disabled, limited, or reserved for selected workflows.

Troubleshooting

If a workflow that depends on a managed API is unavailable or fails, check whether the API is enabled in Settings > Integrations, whether your organization allows it, whether the required key is configured, and whether the provider is temporarily unavailable or rate-limited.