Skip to content

Name freee's API root in the catalog - #43

Merged
haruotsu merged 1 commit into
mainfrom
freee-base-url
Aug 28, 2026
Merged

Name freee's API root in the catalog#43
haruotsu merged 1 commit into
mainfrom
freee-base-url

Conversation

@haruotsu

Copy link
Copy Markdown
Collaborator

Why

freee's API root is https://api.freee.co.jp for every installation — the tenant is chosen by the token, not the URL. Yet an agent with an openapi: toolset on the connection was refused by gete validate until the installation set connections.freee.base_url in its gete.yaml, restating a value it has no say in. That shape is meant for services whose root moves with the installation (GitHub Enterprise, a Zendesk subdomain); freee's does not.

What

  • The catalog entry declares base_url: https://api.freee.co.jp instead of listing the host: base_url puts api.freee.co.jp on hosts and gives openapi toolsets their root, so the entry says the same thing once.
  • A conformance test pins the root, and a validate test shows an openapi toolset on freee passing with nothing under connections in gete.yaml.

Installations that already set connections.freee.base_url keep working: the override merges over the same value.

freee's API root is the same for every installation - the tenant is
chosen by the token, not the URL - yet an openapi toolset on the
connection was refused until the installation set
connections.freee.base_url in gete.yaml, restating a value it had no
say in. That shape is meant for services whose root moves with the
installation; freee's does not, so the catalog now names the root
itself: base_url supplies the only host and gives openapi toolsets
their URLs.

🤖 Generated with Claude Code
@haruotsu
haruotsu merged commit 48b39ac into main Aug 28, 2026
3 checks passed
@haruotsu
haruotsu deleted the freee-base-url branch August 28, 2026 07:17
@github-actions github-actions Bot mentioned this pull request Aug 28, 2026
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