Skip to content

docs(data-governance): add EU endpoint page - #49

Merged
tristantelleb merged 9 commits into
mainfrom
docs/eu-endpoint
May 22, 2026
Merged

docs(data-governance): add EU endpoint page#49
tristantelleb merged 9 commits into
mainfrom
docs/eu-endpoint

Conversation

@tristantelleb

@tristantelleb tristantelleb commented May 21, 2026

Copy link
Copy Markdown
Member

Summary

  • New page at v3/data-governance/eu-endpoint.mdx documenting api.eu.edenai.run: base URLs, request samples, region-filtered discovery, and the HTTP 451 response shape for non-EU providers.
  • Adds the page to the Data Governance nav group in docs.json.

Covers the EDE3-389 work merged in edenai-back#2429 and aifeatures#259.

Verified against the live API

  • regions field shape on /v3/models and /v3/info — confirmed [{"code":"eu","name":"Europe"}].
  • mistral/mistral-large-latest is EU-eligible (used in the Python/JS/curl sample).
  • openai/gpt-4o is not EU-eligible (used in the 451 example) — 0 of 81 OpenAI models surface on the EU host.
  • EU is a strict subset: 105/557 LLM models, 131/200 expert-model entries.
  • Intentionally dropped a ?region=eu preview section after live testing showed v3 endpoints read request.state.region (host only), not the query param — resolve_request_region is defined in aifeatures but not currently wired to a route.

Test plan

  • Mintlify preview renders the new page under Data Governance → EU Endpoint
  • Code samples are copy-pasteable and run cleanly (curl/Python/JS)
  • Internal links to servers-location, data-retention, listing-models resolve

🤖 Generated with Claude Code

Summary by CodeRabbit

  • Documentation
    • Added comprehensive EU regional endpoint documentation including base URL configuration, multi-language code examples, model discovery and filtering for EU-eligible providers, error handling specifications, and caching behavior for EU-scoped requests.

Review Change Stack

Document api.eu.edenai.run: base URL, code samples, region-filtered
discovery, and the 451 rejection shape for non-EU providers. Verified
against live /v3/models and /v3/info on both hosts.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@coderabbitai

coderabbitai Bot commented May 21, 2026

Copy link
Copy Markdown

Warning

Rate limit exceeded

@tristantelleb has exceeded the limit for the number of commits that can be reviewed per hour. Please wait 59 minutes and 2 seconds before requesting another review.

You’ve run out of usage credits. Purchase more in the billing tab.

⌛ How to resolve this issue?

After the wait time has elapsed, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans have higher rate limits than the trial, open-source and free plans. In all cases, we re-allow further reviews after a brief timeout.

Please see our FAQ for further information.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 1fb98b63-2daa-4247-b0bb-e29f3a063d0e

📥 Commits

Reviewing files that changed from the base of the PR and between f613194 and 9b65e8b.

📒 Files selected for processing (6)
  • docs.json
  • v3/data-governance/data-retention.mdx
  • v3/data-governance/eu-endpoint.mdx
  • v3/data-governance/servers-location.mdx
  • v3/expert-models/listing-models.mdx
  • v3/llms/listing-models.mdx

Walkthrough

A new EU regional endpoint documentation page is introduced alongside a navigation configuration update. The documentation explains the EU endpoint's base URL, demonstrates request examples in cURL, Python, and JavaScript, describes EU-available model discovery behavior, specifies HTTP 451 error handling for unavailable providers, and lists behavioral characteristics and related topics.

Changes

EU Endpoint Documentation

Layer / File(s) Summary
Navigation configuration
docs.json
Navigation entry added under Data Governance for the new EU endpoint page.
EU Endpoint documentation page
v3/data-governance/eu-endpoint.mdx
New page with metadata, introduction explaining regional routing, base URL reference table, usage examples in cURL/Python/JavaScript pointing to the EU host, EU model discovery behavior and example payloads, HTTP 451 error specification for unavailable providers/models, operational behavior notes on caching and fallbacks, and navigation cards linking to related EU and data governance documentation.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

Poem

🐰 A European endpoint takes the stage,
Clear docs in every line and page,
With cURL examples, safe and sound,
And error codes well-bound,
The data flows with regional pride! 🇪🇺

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title 'docs(data-governance): add EU endpoint page' directly and accurately summarizes the main change: adding a new EU endpoint documentation page to the data-governance section.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch docs/eu-endpoint

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@mintlify

mintlify Bot commented May 21, 2026

Copy link
Copy Markdown

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
edenai 🟢 Ready View Preview May 21, 2026, 1:00 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@v3/data-governance/eu-endpoint.mdx`:
- Around line 26-27: Replace the literal placeholder "YOUR_API_KEY" in all curl
examples (e.g., the POST example for chat/completions and the other occurrences
noted) with the documented production placeholder format "Bearer <api_token>" so
examples use Authorization: Bearer <api_token>; also ensure any testing/sandbox
examples use "Bearer <sandbox_api_token>" where appropriate and that the header
text reads Authorization: Bearer <api_token> (or <sandbox_api_token>)
consistently across the file.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 5dcf4621-c912-43c1-a1d3-45ee9fa6277d

📥 Commits

Reviewing files that changed from the base of the PR and between 92f7521 and f613194.

📒 Files selected for processing (2)
  • docs.json
  • v3/data-governance/eu-endpoint.mdx

Comment thread v3/data-governance/eu-endpoint.mdx
tristantelleb and others added 2 commits May 21, 2026 15:04
/v3/models and /v3/info are public — the original samples carried a
Bearer token that the endpoints don't require.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
The earlier merge of main into this branch dropped the General, Data
Governance, and Integrations groups and reassigned the EU endpoint
page into Video Generation Features. Rebuild from main with just the
intended single-line addition under Data Governance.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
LLM endpoints wrap region rejections in the OpenAI-compatible error
envelope (error.message / error.type=request_forbidden / error.code=
region_not_allowed), not FastAPI's {"detail": {...}} shape. Document
both shapes since universal-ai still uses the FastAPI envelope.

Verified live with google/gemini-3.5-flash on api.eu.edenai.run.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Match the project-wide convention (quickstart, fallback, llm endpoints,
expert-models): every code section uses Python + JavaScript + cURL in
a CodeGroup, wrapped in Tabs when there are multiple endpoints.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Surface the EU endpoint with the earth-europe icon on the four pages
where it's a direct conceptual sibling: both data-governance pages,
and the two listing-models pages (where the regions field on each
model is the discovery hook for EU availability).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@tristantelleb
tristantelleb merged commit 5a36b6e into main May 22, 2026
6 checks passed
@tristantelleb
tristantelleb deleted the docs/eu-endpoint branch June 8, 2026 07:52
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant