paperclipai/paperclip · error · ApiError

Paperclip API request failed with status ${status}

Error message

Paperclip API request failed with status ${status}

What it means

Error "Paperclip API request failed with status ${status}" thrown in paperclipai/paperclip.

Source

Thrown at packages/adapters/hermes/skills/paperclip-task-bridge/paperclip-task.mjs:158

    Accept: "application/json",
    ...(options.body !== undefined ? { "Content-Type": "application/json" } : {}),
    ...(options.mutating && config.runId ? { "X-Paperclip-Run-Id": config.runId } : {}),
  };
  const response = await fetch(`${config.apiBaseUrl}${path}`, {
    method: options.method ?? "GET",
    headers,
    body: options.body === undefined ? undefined : JSON.stringify(options.body),
  });
  const text = await response.text();
  let body = null;
  if (text) {
    try {
      body = JSON.parse(text);
    } catch {
      body = { error: text.slice(0, 1000) };
    }
  }
  if (!response.ok) throw new ApiError(response.status, body);
  return body;
}

async function resolveIdentity(config) {
  if (config.companyId && config.agentId) {
    return { companyId: config.companyId, agentId: config.agentId, agent: null };
  }
  const agent = await apiFetch(config, "/agents/me");
  const companyId = config.companyId || agent.companyId;
  const agentId = config.agentId || agent.id;
  if (!companyId || !agentId) throw new ApiError(500, { error: "Paperclip identity response did not include companyId and agent id" });
  return { companyId, agentId, agent };
}

function issueSummary(issue) {
  if (!issue || typeof issue !== "object") return issue;
  return {
    id: issue.id ?? null,

View on GitHub (pinned to 120ae5428f)

Solutions

1. Check the status code: verify the API key and URL on 401/404, fix the payload on 4xx, retry on 5xx.

When it happens

Trigger: Thrown at packages/adapters/hermes/skills/paperclip-task-bridge/paperclip-task.mjs:158 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of paperclipai/paperclip@120ae5428f (2026-08-18). Data as JSON: /api/errors/90b3ef467aef07bb. Report an issue: GitHub.