Skip to content

[bug] Notion REST healthcheck needs a pinned Notion-Version header #2059

Description

@thesobercoder

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

  1. Add the Notion REST OpenAPI integration.
  2. Create an API-key connection.
  3. Check the connection health.
  4. 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.

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions