paperclipai/paperclip · error · Error

No data handler registered for key "${params.key}"

Error message

No data handler registered for key "${params.key}"

What it means

Dispatch guard in the worker RPC host (handleGetData): the host requested a data handler for params.key, but no data handler was registered under that key by the plugin. The key/protocol are correct; the plugin simply does not expose that data source, so the RPC request is rejected.

Source

Thrown at packages/plugins/sdk/src/worker-rpc-host.ts:1889

        await registration.fn(event);
      } catch (err) {
        // Log error but continue processing other handlers so one failing
        // handler doesn't prevent the rest from running.
        notifyHost("log", {
          level: "error",
          message: `Event handler for "${registration.name}" failed: ${
            err instanceof Error ? err.message : String(err)
          }`,
          meta: { eventType: event.eventType, stack: err instanceof Error ? err.stack : undefined },
        });
      }
    }
  }

  async function handleRunJob(params: RunJobParams): Promise<void> {
    const handler = jobHandlers.get(params.job.jobKey);
    if (!handler) {
      throw new Error(`No handler registered for job "${params.job.jobKey}"`);
    }
    await handler(params.job);
  }

  async function handleWebhook(params: PluginWebhookInput): Promise<void> {
    if (!plugin.definition.onWebhook) {
      throw Object.assign(
        new Error("handleWebhook is not implemented by this plugin"),
        { code: PLUGIN_RPC_ERROR_CODES.METHOD_NOT_IMPLEMENTED },
      );
    }
    await plugin.definition.onWebhook(params);
  }

  async function handleApiRequest(params: PluginApiRequestInput): Promise<unknown> {
    if (!plugin.definition.onApiRequest) {
      throw Object.assign(
        new Error("handleApiRequest is not implemented by this plugin"),

View on GitHub (pinned to 01ad858492)

Solutions

1. Register a data handler for the key, or request a registered key.

When it happens

Trigger: Thrown at packages/plugins/sdk/src/worker-rpc-host.ts:1838 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of paperclipai/paperclip@01ad858492 (2026-08-18). Data as JSON: /api/errors/f1e92840c47e92c7. Report an issue: GitHub.