# submitFeedback

Mutation

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.

Available to agents as MCP tool `submitFeedback` — see [Write tools](/api/v2/docs/mcp/write-tools#submit-feedback).

## Arguments

| Name | Type | Required | Default | Description |
| --- | --- | --- | --- | --- |
| `input` | [`SubmitFeedbackInput!`](/api/v2/docs/types/submit-feedback-input) | Yes | — | Mutation input. |

## Returns

| Name | Type | Description |
| --- | --- | --- |
| `feedback` | [`FeedbackReceipt`](/api/v2/docs/types/feedback-receipt) | Receipt for the stored report. Null when userErrors is non-empty. |
| `userErrors` | [`[UserError!]!`](/api/v2/docs/types/user-error) | Why the report was refused: an invalid field, or the workspace feedback limit. Empty on success. |

## Examples

### Report a problem to the Archive team

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

```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"
  }
}
```

Response — HTTP 200:

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