Executor version
Current self-hosted build
How do you run Executor?
Self-hosted
Integration involved
Notion REST API / OpenAPI integration
What happened
The Notion REST connection works for ordinary calls when the request includes:
Notion-Version: 2025-09-03
However, the connection healthcheck is not configured automatically. The UI cannot pin this required header as a healthcheck argument, so the connection initially reports unknown with No health check configured.
The healthcheck can be repaired manually with this configuration:
{
"operation": "users.getSelf",
"args": {
"Notion-Version": "2025-09-03"
},
"identityField": "id"
}
Note that the healthcheck must use Executor's generated tool name users.getSelf, not the raw OpenAPI operation ID get-self.
What I expected
The Notion REST integration should have a zero-config healthcheck, or the UI should allow pinning required header arguments for the selected healthcheck operation.
Steps to reproduce
- Add the Notion REST OpenAPI integration.
- Create an API-key connection.
- Check the connection health.
- Observe that the healthcheck is missing or fails unless
Notion-Version is supplied.
Proposed fix
Ship the Notion integration preset with:
{
"operation": "users.getSelf",
"args": {
"Notion-Version": "2025-09-03"
},
"identityField": "id"
}
Alternatively, expose the integration healthcheck setter and pinned header arguments in the UI.
Executor version
Current self-hosted build
How do you run Executor?
Self-hosted
Integration involved
Notion REST API / OpenAPI integration
What happened
The Notion REST connection works for ordinary calls when the request includes:
Notion-Version: 2025-09-03However, the connection healthcheck is not configured automatically. The UI cannot pin this required header as a healthcheck argument, so the connection initially reports
unknownwithNo health check configured.The healthcheck can be repaired manually with this configuration:
{ "operation": "users.getSelf", "args": { "Notion-Version": "2025-09-03" }, "identityField": "id" }Note that the healthcheck must use Executor's generated tool name
users.getSelf, not the raw OpenAPI operation IDget-self.What I expected
The Notion REST integration should have a zero-config healthcheck, or the UI should allow pinning required header arguments for the selected healthcheck operation.
Steps to reproduce
Notion-Versionis supplied.Proposed fix
Ship the Notion integration preset with:
{ "operation": "users.getSelf", "args": { "Notion-Version": "2025-09-03" }, "identityField": "id" }Alternatively, expose the integration healthcheck setter and pinned header arguments in the UI.