Skip to content

integrations: Fix API URL in Home Assistant documentation. - #40197

Merged
laurynmm merged 1 commit into
zulip:mainfrom
Aditya-XR:fix-homeassistant-doc-api-url
Oct 2, 2026
Merged

laurynmm merged 1 commit into
zulip:mainfrom
Aditya-XR:fix-homeassistant-doc-api-url

Conversation

@Aditya-XR

@Aditya-XR Aditya-XR commented Sep 23, 2026 •

Copy link
Copy Markdown
Collaborator

The configuration.yaml example in the Home Assistant integration doc used external_api_uri, which isn't defined for that template, so it rendered as an empty string and the example showed a broken resource: http: v1/external/homeassistant URL. This uses {{ api_url }}, like the rest of the same doc.

Split out of #40191 at the reviewer's request.

Fixes: part of #23380.

How changes were tested:

Opened the Home Assistant integration doc in the dev server before and after the change and checked the rendered resource: URL.

Screenshots and screen captures:

Before After
before after
Self-review checklist
  • Self-reviewed the changes for clarity and maintainability
    (variable names, code reuse, readability, etc.).
  • Followed the AI use policy.

Communicate decisions, questions, and potential concerns.

  • Explains differences from previous plans (e.g., issue description).
  • Highlights technical choices and bugs encountered.
  • Calls out remaining decisions and concerns.
  • Automated tests verify logic where appropriate.

Individual commits are ready for review (see commit discipline).

  • Each commit is a coherent idea.
  • Commit message(s) explain reasoning and motivation for changes.

Completed manual review and testing of the following:

  • Visual appearance of the changes.
  • Responsiveness and internationalization.
  • Strings and tooltips.
  • End-to-end functionality of buttons, interactions and flows.
  • Corner cases, error conditions, and easily imagined bugs.

Copilot AI 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.

Copilot review overview

🟢 Approval recommended

No unresolved review issues remain.

Review effort: Lite
Findings: None

What changed in this PR

Updates the Home Assistant documentation to use the valid api_url template variable.

Changes:

  • Replaces undefined external_api_uri.
  • Corrects the documented API resource URL.
File Description
zerver/​webhooks/​homeassistant/​doc.md Corrects the Home Assistant API URL template.

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

@laurynmm laurynmm self-assigned this Sep 30, 2026
@laurynmm laurynmm added the integration review Added by maintainers when a PR may be ready for integration. label Sep 30, 2026
The configuration.yaml example used `external_api_uri` as a
template variable, which rendered as an empty string since that
context variable was removed in commit 271a9f0. It was
likely added to this documentation as a copy and paste error.

Updated the documentation to us the `api_url` context variable
instead.
@laurynmm
laurynmm force-pushed the fix-homeassistant-doc-api-url branch from 17f7314 to f66e989 Compare October 2, 2026 15:15
@laurynmm

laurynmm commented Oct 2, 2026

Copy link
Copy Markdown
Collaborator

@Aditya-XR - Thanks for moving this to a separate change. I've updated the commit message to note when the external_api_uri context variable was removed from the code base. Marking to merge when the CI completes.

@laurynmm
laurynmm enabled auto-merge (rebase) October 2, 2026 15:16
@laurynmm
laurynmm merged commit 2b1bdee into zulip:main Oct 2, 2026
12 checks passed
@Aditya-XR
Aditya-XR deleted the fix-homeassistant-doc-api-url branch October 3, 2026 23:05
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

integration review Added by maintainers when a PR may be ready for integration. size: XS

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants