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.

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@3f1d897a7c (2026-08-18). Data as JSON: /api/errors/8d481a522d0e4ccc. Report an issue: GitHub.

Appendix: source

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

          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 3f1d897a7c)