docs: update links for local evaluation and edge proxy docs

[nattiechan]

Thanks for submitting a PR! Please check the boxes below:

• I have read the Contributing Guide.
• I have added information to docs/ if required so people know about the feature.
• I have filled in the "Changes" section below.
• I have filled in the "How did you test this code" section below.

Changes

Based on my experience implementing Flagsmith Client SDK, and Server SDK via edge proxy, I decided to update some of the documentation around local evaluation and edge proxy to clear up some confusion I had during the implementation. The contribution stemmed from this discord message: https://discord.com/channels/517647859495993347/917719343930957846/1521555745798226093

• Update links for local evaluation and caveats to a more specific section for more context
• Add a bullet point on identity override troubleshooting for edge proxy

I also updated the openAPI docs accordingly per README in /docs, though unsure if I have done it correctly.

How did you test this code?

Ran server locally via make serve to visualize the changes locally.

[vercel]

@nattiechan is attempting to deploy a commit to the Flagsmith Team on Vercel.

A member of the Team first needs to authorize it.

[coderabbitai]

📝 Walkthrough

Walkthrough

This pull request updates documentation link targets from an older integration-overview URL structure to SDK-specific anchors for Local Evaluation Mode and Environment Document references across several docs pages. It also adds new Edge Proxy api_url documentation and troubleshooting content, introduces a new SDK API tag page with sidebar wiring, and regenerates encoded API payloads and JSON schemas for multiple SDK API reference pages.

Estimated code review effort: 2 (Simple) | ~15 minutes

Changes

File(s)	Summary
billing-api-usage.md, governance-and-compliance/api-usage.md, defensive-coding.md, efficient-api-usage.md, getting-started/glossary.md, integrating-with-flagsmith/sdks/index.md, performance/edge-proxy.md	Updated Local Evaluation Mode / Environment Document link targets to SDK-specific anchors
deployment-self-hosting/edge-proxy.md	Added api_url config documentation and a troubleshooting bullet
sdk-api/sdk.tag.mdx, sdk-api/sidebar.ts	Added new SDK API tag page and sidebar link
sdk-api/flagsmith-api.info.mdx, sdk-api/sdk-v-1-environment-document.api.mdx, sdk-api/sdk-v-1-flags.api.mdx, sdk-api/sdk-v-1-get-identities.api.mdx, sdk-api/sdk-v-1-post-identities.api.mdx	Regenerated encoded API payloads and updated response/request JSON schemas

Sequence Diagram(s)

Not applicable — this PR consists of documentation link/content updates and regenerated API reference schemas with no observable runtime interaction flow.

Related issues: None specified.

Related PRs: None specified.

Suggested labels: documentation

Suggested reviewers: None specified.

---

_{Comment @coderabbitai help to get the list of available commands.}

[coderabbitai]

Actionable comments posted: 2

---

ℹ️ Review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: ASSERTIVE

Plan: Pro Plus

Run ID: 9f45b787-8937-428e-85c2-af8abc9a2a9f

📥 Commits

Reviewing files that changed from the base of the PR and between da194ca and 0a9a01e.

📒 Files selected for processing (15)

• docs/docs/administration-and-security/billing-api-usage.md
• docs/docs/administration-and-security/governance-and-compliance/api-usage.md
• docs/docs/best-practices/defensive-coding.md
• docs/docs/best-practices/efficient-api-usage.md
• docs/docs/deployment-self-hosting/edge-proxy.md
• docs/docs/getting-started/glossary.md
• docs/docs/integrating-with-flagsmith/sdks/index.md
• docs/docs/performance/edge-proxy.md
• docs/docs/sdk-api/flagsmith-api.info.mdx
• docs/docs/sdk-api/sdk-v-1-environment-document.api.mdx
• docs/docs/sdk-api/sdk-v-1-flags.api.mdx
• docs/docs/sdk-api/sdk-v-1-get-identities.api.mdx
• docs/docs/sdk-api/sdk-v-1-post-identities.api.mdx
• docs/docs/sdk-api/sdk.tag.mdx
• docs/docs/sdk-api/sidebar.ts

[coderabbitai]

Actionable comments posted: 1

---

ℹ️ Review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: ASSERTIVE

Plan: Pro Plus

Run ID: d10c31f1-548e-46db-90cc-06ec405d61aa

📥 Commits

Reviewing files that changed from the base of the PR and between 0a9a01e and 05459ee.

📒 Files selected for processing (15)

• docs/docs/administration-and-security/billing-api-usage.md
• docs/docs/administration-and-security/governance-and-compliance/api-usage.md
• docs/docs/best-practices/defensive-coding.md
• docs/docs/best-practices/efficient-api-usage.md
• docs/docs/deployment-self-hosting/edge-proxy.md
• docs/docs/getting-started/glossary.md
• docs/docs/integrating-with-flagsmith/sdks/index.md
• docs/docs/performance/edge-proxy.md
• docs/docs/sdk-api/flagsmith-api.info.mdx
• docs/docs/sdk-api/sdk-v-1-environment-document.api.mdx
• docs/docs/sdk-api/sdk-v-1-flags.api.mdx
• docs/docs/sdk-api/sdk-v-1-get-identities.api.mdx
• docs/docs/sdk-api/sdk-v-1-post-identities.api.mdx
• docs/docs/sdk-api/sdk.tag.mdx
• docs/docs/sdk-api/sidebar.ts

[coderabbitai]

🗄️ Data Integrity & Integration | 🟡 Minor | ⚡ Quick win

🧩 Analysis chain

🏁 Script executed:

#!/bin/bash
set -euo pipefail

# Locate the affected docs file and nearby source specs/definitions.
git ls-files | rg -n 'docs/docs/sdk-api/sdk-v-1-post-identities\.api\.mdx|sdk-v-1-post-identities|identities|trait_value|traits'

Repository: Flagsmith/flagsmith

Length of output: 5927

---

🏁 Script executed:

#!/bin/bash
set -euo pipefail

# Inspect the OpenAPI/spec and serializer definitions for the trait value limit.
for f in \
  api/environments/identities/traits/openapi.py \
  api/environments/identities/traits/serializers.py \
  api/environments/identities/traits/constants.py \
  api/util/engine_models/identities/traits/types.py \
  api/tests/unit/environments/identities/traits/test_unit_traits_serializers.py \
  docs/docs/sdk-api/sdk-v-1-post-identities.api.mdx
do
  echo "===== $f ====="
  wc -l "$f"
done

echo "===== rg trait_value / maxLength ====="
rg -n "trait_value|maxLength|2000" \
  api/environments/identities/traits/openapi.py \
  api/environments/identities/traits/serializers.py \
  api/environments/identities/traits/constants.py \
  api/util/engine_models/identities/traits/types.py \
  api/tests/unit/environments/identities/traits/test_unit_traits_serializers.py \
  docs/docs/sdk-api/sdk-v-1-post-identities.api.mdx

Repository: Flagsmith/flagsmith

Length of output: 8186

---

🏁 Script executed:

#!/bin/bash
set -euo pipefail

echo "===== api/environments/identities/traits/constants.py ====="
cat -n api/environments/identities/traits/constants.py

echo "===== api/environments/identities/traits/serializers.py ====="
cat -n api/environments/identities/traits/serializers.py

echo "===== api/environments/identities/traits/openapi.py ====="
cat -n api/environments/identities/traits/openapi.py

echo "===== api/util/engine_models/identities/traits/types.py ====="
cat -n api/util/engine_models/identities/traits/types.py

echo "===== api/tests/unit/environments/identities/traits/test_unit_traits_serializers.py ====="
cat -n api/tests/unit/environments/identities/traits/test_unit_traits_serializers.py

Repository: Flagsmith/flagsmith

Length of output: 11146

---

🏁 Script executed:

#!/bin/bash
set -euo pipefail

echo "===== usages of TRAIT_STRING_VALUE_MAX_LENGTH ====="
rg -n "TRAIT_STRING_VALUE_MAX_LENGTH|StringConstraints|max_length=2000|2000" api docs frontend

echo "===== TraitValueField definition ====="
fd -a 'fields.py' api/environments/identities/traits api/util/engine_models/identities/traits
cat -n api/environments/identities/traits/fields.py

echo "===== SDK serializer and view usage ====="
rg -n "SDKBulkCreateUpdateTraitSerializer|TraitValueField|TraitValueFieldExtension|traits" api/environments api/tests/unit/environments api/tests/integration/environments

Repository: Flagsmith/flagsmith

Length of output: 50376

---

🏁 Script executed:

#!/bin/bash
set -euo pipefail

echo "===== usages of TRAIT_STRING_VALUE_MAX_LENGTH ====="
rg -n "TRAIT_STRING_VALUE_MAX_LENGTH|StringConstraints|max_length=2000|2000" api docs frontend

echo "===== TraitValueField definition ====="
cat -n api/environments/identities/traits/fields.py

echo "===== SDK serializer and view usage ====="
rg -n "SDKBulkCreateUpdateTraitSerializer|TraitValueField|TraitValueFieldExtension|traits" api/environments api/tests/unit api/tests/integration

Repository: Flagsmith/flagsmith

Length of output: 50376

---

Restore the 2000-character limit for traits[].trait_value
docs/docs/sdk-api/sdk-v-1-post-identities.api.mdx:57-65 now advertises arbitrary-length strings, but the API still caps string traits at 2000 characters. Update the schema to match the server-side limit, or widen the validator too.

🧰 Tools

🪛 Betterleaks (1.6.0)

[high] 8-8: Detected a Generic API Key, potentially exposing access to various services and sensitive operations.

(generic-api-key)