paperclipai/paperclip · error · ToolGatewayHttpError

action_declined

action_declined

Error message

This tool action was declined; do not retry the same call

What it means

Deduplication path: a matching prior action request for the same tool and arguments hash was found in declined state. Instead of re-running or re-asking, the gateway returns this 409 telling the agent the identical call was already declined by a human and must not be retried unchanged.

Source

Thrown at server/src/services/tool-gateway.ts:4592

        config: { command: "claude", args: ["mcp", "add", gateway.name, endpoint, "--header", `Authorization: Bearer ${bearerPlaceholder}`] },
        notes: ["Use the equivalent remote HTTP MCP add command for your installed version."],
      },
      {
        client: "opencode",
        label: "OpenCode",
        config: { mcp: { [gateway.name]: { url: endpoint, headers: { Authorization: `Bearer ${bearerPlaceholder}` } } } },
        notes: ["Use the full Paperclip origin before the endpoint path."],
      },
    ];
  }

  function toGateway(row: typeof toolMcpGateways.$inferSelect): ToolMcpGateway {
    return {
      id: row.id,
      companyId: row.companyId,
      gatewayPublicId: row.gatewayPublicId,
      name: row.name,
      displaySlug: row.displaySlug || row.slug,
      slug: row.slug,
      description: row.description,
      status: row.status,
      profileId: row.profileId,
      defaultProfileMode: row.defaultProfileMode,
      contextScopeType: row.contextScopeType,
      contextScopeId: row.contextScopeId,
      agentId: row.agentId,
      projectId: row.projectId,
      issueId: row.issueId,
      approvalIssueId: row.approvalIssueId,
      endpointPath: gatewayEndpointPath(row.gatewayPublicId),
      authConfig: row.authConfig,
      headerPolicy: row.headerPolicy,
      metadataPolicy: row.metadataPolicy,
      onDemandToolsConfig: row.onDemandToolsConfig,
      metadata: row.metadata ?? {},
      createdByAgentId: row.createdByAgentId,

View on GitHub (pinned to 01ad858492)

Solutions

1. The action was declined. Do not retry the same call; change the request or ask the board for guidance.

When it happens

Trigger: Thrown at server/src/services/tool-gateway.ts:4424 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/8d481a522d0e4ccc. Report an issue: GitHub.