Mutation

submitFeedback

Report a problem with the Archive API (a bug, unclear docs, a missing capability, an unexpected result) to the Archive team. Not visible to workspace users; no reply.

MCP: submitFeedback

Arguments

Object, input and enum types open in place — use + to reveal their fields. A type that is already open above the row stops at a ↻ circular marker, and anything nested past the depth limit links out to its own page instead.

input SubmitFeedbackInput! required: Mutation input.
category FeedbackCategory! required: What kind of problem this is.
BUG: Archive behaved incorrectly: an error, a crash, or a result that contradicts the documentation.
MISSING_CAPABILITY: The task needed something the API cannot do yet.
OTHER: Anything else worth telling the Archive team.
PERFORMANCE: A call was too slow, timed out, or cost more rate limit than expected.
UNCLEAR_DOCS: A tool, field or argument description was missing, ambiguous or wrong.
UNEXPECTED_RESULT: A call succeeded but returned data that looks wrong, incomplete or surprising.
errorMessage String: The error text you received, if any, at most 1000 characters.
exampleCall JSON: The arguments of a call that shows the problem, as a JSON object of at most 8192 bytes once serialized. Stored for the Archive team only.
message String! required: What happened and what you expected instead, 20 to 4000 characters after trimming. One issue per report.
toolName String: The MCP tool the report is about, by its exact registered name (e.g. "searchItems"). Omit when the report is not about one tool.

Returns

feedback FeedbackReceipt: Receipt for the stored report. Null when userErrors is non-empty.
duplicate Boolean!: True when the same report was already submitted for this workspace in the last 24 hours; the id is that earlier report and nothing new was stored or sent.
id ID!: Id of the stored report. Quote it if you mention the report to the user.
userErrors [UserError!]!: Why the report was refused: an invalid field, or the workspace feedback limit. Empty on success.
field [String!]: Path to the input field that caused the error.
message String!: The error message.

Open in explorer ↗

Values are sampled from a demo workspace — substitute your own token and workspace id.

Send one report about an Archive bug, unclear docs or a missing capability; the receipt is its id.

query.graphql

mutation SubmitFeedbackDefault($input: SubmitFeedbackInput!) {
  submitFeedback(input: $input) {
    feedback {
      id
      duplicate
    }
    userErrors {
      field
      message
    }
  }
}

variables.json

{
  "input": {
    "category": "UNCLEAR_DOCS",
    "message": "The searchItems description does not say whether dateRange.to is inclusive.",
    "toolName": "searchItems"
  }
}

Headers

Authorization: Bearer docs_demo_token_0000000000000000000000
WORKSPACE-ID: 6ccefa76-e8ba-5ab0-9c60-e48a9e235a4a

Request · cURL

curl https://app.archive.com/api/v2 \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer docs_demo_token_0000000000000000000000' \
  -H 'WORKSPACE-ID: 6ccefa76-e8ba-5ab0-9c60-e48a9e235a4a' \
  -d '{
  "query": "mutation SubmitFeedbackDefault($input: SubmitFeedbackInput!) {\n  submitFeedback(input: $input) {\n    feedback {\n      id\n      duplicate\n    }\n    userErrors {\n      field\n      message\n    }\n  }\n}",
  "variables": {
    "input": {
      "category": "UNCLEAR_DOCS",
      "message": "The searchItems description does not say whether dateRange.to is inclusive.",
      "toolName": "searchItems"
    }
  }
}'

Request · Node.js

const response = await fetch("https://app.archive.com/api/v2", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer docs_demo_token_0000000000000000000000",
    "WORKSPACE-ID": "6ccefa76-e8ba-5ab0-9c60-e48a9e235a4a"
  },
  body: JSON.stringify({
    query: `mutation SubmitFeedbackDefault($input: SubmitFeedbackInput!) {
  submitFeedback(input: $input) {
    feedback {
      id
      duplicate
    }
    userErrors {
      field
      message
    }
  }
}`,
    variables: {
      "input": {
        "category": "UNCLEAR_DOCS",
        "message": "The searchItems description does not say whether dateRange.to is inclusive.",
        "toolName": "searchItems"
      }
    }
  })
})
console.log(JSON.stringify(await response.json(), null, 2))

Request · Ruby

require "json"
require "net/http"

query = <<~'GRAPHQL'
  mutation SubmitFeedbackDefault($input: SubmitFeedbackInput!) {
    submitFeedback(input: $input) {
      feedback {
        id
        duplicate
      }
      userErrors {
        field
        message
      }
    }
  }
GRAPHQL

response = Net::HTTP.post(
  URI("https://app.archive.com/api/v2"),
  { query: query, variables: { "input" => { "category" => "UNCLEAR_DOCS", "message" => "The searchItems description does not say whether dateRange.to is inclusive.", "toolName" => "searchItems" } } }.to_json,
  "Content-Type" => "application/json",
  "Authorization" => "Bearer docs_demo_token_0000000000000000000000",
  "WORKSPACE-ID" => "6ccefa76-e8ba-5ab0-9c60-e48a9e235a4a"
)
puts response.body

Request · Python

import json
import requests

query = """
mutation SubmitFeedbackDefault($input: SubmitFeedbackInput!) {
  submitFeedback(input: $input) {
    feedback {
      id
      duplicate
    }
    userErrors {
      field
      message
    }
  }
}
"""

response = requests.post(
    "https://app.archive.com/api/v2",
    json={"query": query, "variables": {"input": {"category": "UNCLEAR_DOCS", "message": "The searchItems description does not say whether dateRange.to is inclusive.", "toolName": "searchItems"}}},
    headers={
        "Authorization": "Bearer docs_demo_token_0000000000000000000000",
        "WORKSPACE-ID": "6ccefa76-e8ba-5ab0-9c60-e48a9e235a4a",
    },
)
print(json.dumps(response.json(), indent=2))

200 OK 11 lines

{
  "data": {
    "submitFeedback": {
      "feedback": {
        "id": "74c47612-5eab-5a07-a89f-32f6375af6d4",
        "duplicate": false
      },
      "userErrors": []
    }
  }
}