Tell Patch's team what got in your way

curl --request POST \
  --url https://patch.gg/api/v1/feedback \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data @- <<EOF
{
  "summary": "create_release's upload links ran out before a 900 MB upload finished",
  "goal": "<string>",
  "expected": "<string>",
  "actual": "<string>",
  "tried": "<string>",
  "workaround": "<string>",
  "would_help": "<string>",
  "cost": "<string>",
  "details": "<string>",
  "tool": "create_release",
  "error_code": "upload_expired",
  "project": "<string>",
  "agent": "<string>",
  "add_to": "<string>"
}
EOF

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    summary: 'create_release\'s upload links ran out before a 900 MB upload finished',
    goal: '<string>',
    expected: '<string>',
    actual: '<string>',
    tried: '<string>',
    workaround: '<string>',
    would_help: '<string>',
    cost: '<string>',
    details: '<string>',
    tool: 'create_release',
    error_code: 'upload_expired',
    project: '<string>',
    agent: '<string>',
    add_to: '<string>'
  })
};

fetch('https://patch.gg/api/v1/feedback', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://patch.gg/api/v1/feedback"

payload = {
    "summary": "create_release's upload links ran out before a 900 MB upload finished",
    "goal": "<string>",
    "expected": "<string>",
    "actual": "<string>",
    "tried": "<string>",
    "workaround": "<string>",
    "would_help": "<string>",
    "cost": "<string>",
    "details": "<string>",
    "tool": "create_release",
    "error_code": "upload_expired",
    "project": "<string>",
    "agent": "<string>",
    "add_to": "<string>"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "kind": "failed",
  "summary": "<string>",
  "goal": "<string>",
  "expected": "<string>",
  "actual": "<string>",
  "tried": "<string>",
  "workaround": "<string>",
  "would_help": "<string>",
  "cost": "<string>",
  "severity": "blocked",
  "details": "<string>",
  "tool": "<string>",
  "error_code": "<string>",
  "project": "<string>",
  "agent": "<string>",
  "client": "<string>",
  "quality": 123,
  "status": "open",
  "answer": "<string>",
  "created_at": "<string>",
  "answered_at": "<string>",
  "follow_up": {
    "question": "<string>",
    "field": "<string>"
  },
  "known": {
    "status": "open",
    "answer": "<string>",
    "answered_at": "<string>"
  },
  "next": "<string>"
}

{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "kind": "failed",
  "summary": "<string>",
  "goal": "<string>",
  "expected": "<string>",
  "actual": "<string>",
  "tried": "<string>",
  "workaround": "<string>",
  "would_help": "<string>",
  "cost": "<string>",
  "severity": "blocked",
  "details": "<string>",
  "tool": "<string>",
  "error_code": "<string>",
  "project": "<string>",
  "agent": "<string>",
  "client": "<string>",
  "quality": 123,
  "status": "open",
  "answer": "<string>",
  "created_at": "<string>",
  "answered_at": "<string>",
  "follow_up": {
    "question": "<string>",
    "field": "<string>"
  },
  "known": {
    "status": "open",
    "answer": "<string>",
    "answered_at": "<string>"
  },
  "next": "<string>"
}

{
  "error": {
    "code": "version_exists",
    "message": "<string>",
    "details": "<unknown>"
  }
}

{
  "error": {
    "code": "version_exists",
    "message": "<string>",
    "details": "<unknown>"
  }
}

{
  "error": {
    "code": "version_exists",
    "message": "<string>",
    "details": "<unknown>"
  }
}

{
  "error": {
    "code": "version_exists",
    "message": "<string>",
    "details": "<unknown>"
  }
}

Feedback

Tell Patch's team what got in your way

For agents on Patch’s MCP server (send_feedback) and pch (pch feedback send), whenever Patch gets in the way: you couldn’t do what the person asked, Patch did something wrong, a call failed and its error didn’t say what to do, a tool or answer didn’t help, or something would have made it easier. A person at Patch reads every report and can answer it.

Write it for the engineer who’ll fix it: the tool and its error’s code, what you were doing (goal), what you expected, what happened instead in Patch’s own words (actual), what you tried, any workaround, what it cost you, and what would have helped. The answer’s follow_up asks for the one thing a new report is missing that would help most; add it with add_to. Anything that looks like a key is taken out of what you write.

Sending the same summary about the same tool again within a day adds to that report. When the team already answered a report about the same tool and error, known says what they said. It never holds up your work: carry on with what the person asked.

POST

feedback

Tell Patch's team what got in your way

curl --request POST \
  --url https://patch.gg/api/v1/feedback \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data @- <<EOF
{
  "summary": "create_release's upload links ran out before a 900 MB upload finished",
  "goal": "<string>",
  "expected": "<string>",
  "actual": "<string>",
  "tried": "<string>",
  "workaround": "<string>",
  "would_help": "<string>",
  "cost": "<string>",
  "details": "<string>",
  "tool": "create_release",
  "error_code": "upload_expired",
  "project": "<string>",
  "agent": "<string>",
  "add_to": "<string>"
}
EOF

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    summary: 'create_release\'s upload links ran out before a 900 MB upload finished',
    goal: '<string>',
    expected: '<string>',
    actual: '<string>',
    tried: '<string>',
    workaround: '<string>',
    would_help: '<string>',
    cost: '<string>',
    details: '<string>',
    tool: 'create_release',
    error_code: 'upload_expired',
    project: '<string>',
    agent: '<string>',
    add_to: '<string>'
  })
};

fetch('https://patch.gg/api/v1/feedback', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://patch.gg/api/v1/feedback"

payload = {
    "summary": "create_release's upload links ran out before a 900 MB upload finished",
    "goal": "<string>",
    "expected": "<string>",
    "actual": "<string>",
    "tried": "<string>",
    "workaround": "<string>",
    "would_help": "<string>",
    "cost": "<string>",
    "details": "<string>",
    "tool": "create_release",
    "error_code": "upload_expired",
    "project": "<string>",
    "agent": "<string>",
    "add_to": "<string>"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "kind": "failed",
  "summary": "<string>",
  "goal": "<string>",
  "expected": "<string>",
  "actual": "<string>",
  "tried": "<string>",
  "workaround": "<string>",
  "would_help": "<string>",
  "cost": "<string>",
  "severity": "blocked",
  "details": "<string>",
  "tool": "<string>",
  "error_code": "<string>",
  "project": "<string>",
  "agent": "<string>",
  "client": "<string>",
  "quality": 123,
  "status": "open",
  "answer": "<string>",
  "created_at": "<string>",
  "answered_at": "<string>",
  "follow_up": {
    "question": "<string>",
    "field": "<string>"
  },
  "known": {
    "status": "open",
    "answer": "<string>",
    "answered_at": "<string>"
  },
  "next": "<string>"
}

{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "kind": "failed",
  "summary": "<string>",
  "goal": "<string>",
  "expected": "<string>",
  "actual": "<string>",
  "tried": "<string>",
  "workaround": "<string>",
  "would_help": "<string>",
  "cost": "<string>",
  "severity": "blocked",
  "details": "<string>",
  "tool": "<string>",
  "error_code": "<string>",
  "project": "<string>",
  "agent": "<string>",
  "client": "<string>",
  "quality": 123,
  "status": "open",
  "answer": "<string>",
  "created_at": "<string>",
  "answered_at": "<string>",
  "follow_up": {
    "question": "<string>",
    "field": "<string>"
  },
  "known": {
    "status": "open",
    "answer": "<string>",
    "answered_at": "<string>"
  },
  "next": "<string>"
}

{
  "error": {
    "code": "version_exists",
    "message": "<string>",
    "details": "<unknown>"
  }
}

{
  "error": {
    "code": "version_exists",
    "message": "<string>",
    "details": "<unknown>"
  }
}

{
  "error": {
    "code": "version_exists",
    "message": "<string>",
    "details": "<unknown>"
  }
}

{
  "error": {
    "code": "version_exists",
    "message": "<string>",
    "details": "<unknown>"
  }
}

Authorizations

Authorization

string

header

required

An API key (pch_...) or the token from pch login.

Body

application/json

kind

enum<string>

required

failed: you couldn't do what the person asked. bug: Patch did something wrong: a wrong answer, something it said it did that didn't happen, a page or file that's broken. call_error: a call failed and its error didn't say what to do, or it looks like Patch's fault. unhelpful: a tool or its answer didn't help: it misled you, left something out, or you had to guess, retry or work around it. idea: something that would have made it easier, such as a tool, flag or field Patch doesn't have.

Available options:

failed,

bug,

call_error,

unhelpful,

idea

summary

string

required

One line, specific: which tool or command, and what went wrong. Past 200 characters, the rest goes at the top of details

Required string length: 1 - 2000

Example:

"create_release's upload links ran out before a 900 MB upload finished"

goal

string

What you were trying to do for the person

Maximum string length: 2000

expected

string

What you expected Patch to do or say

Maximum string length: 2000

actual

string

What it did or said instead, in its own words

Maximum string length: 8000

tried

string

What you tried, in order

Maximum string length: 8000

workaround

string

What worked around it in the end, if anything did

Maximum string length: 8000

would_help

string

What exactly would have made it easy: the words, the tool, the field or the flag

Maximum string length: 4000

cost

string

What it cost: extra calls, retries, minutes, or a step given up

Maximum string length: 1000

severity

enum<string>

blocked: you couldn't go on. slowed: you went on, slower. annoyed: it only got in the way

Available options:

blocked,

slowed,

annoyed

details

string

Anything else

Maximum string length: 20000

tool

string

The MCP tool or pch command it's about

Maximum string length: 200

Example:

"create_release"

error_code

string

The error's code, as Patch or pch gave it

Maximum string length: 200

Example:

"upload_expired"

project

string

The project it's about, as owner/slug

Maximum string length: 200

agent

string

Which coding agent and model you are

Maximum string length: 200

add_to

string

A report of yours to add this to, such as when answering its follow_up: what's new joins what it said

Maximum string length: 100

Response

Added to a report you'd sent

string<uuid>

required

kind

enum<string>

required

Available options:

failed,

bug,

call_error,

unhelpful,

idea

summary

string

required

goal

string | null

required

expected

string | null

required

actual

string | null

required

tried

string | null

required

workaround

string | null

required

would_help

string | null

required

cost

string | null

required

severity

enum<string> | null

required

blocked: you couldn't go on. slowed: you went on, slower. annoyed: it only got in the way

Available options:

blocked,

slowed,

annoyed,

null

details

string | null

required

tool

string | null

required

error_code

string | null

required

project

string | null

required

agent

string | null

required

client

string

required

mcp, pch, desktop, web or api

quality

integer

required

How much of what its kind needs it has, 0 to 100

status

enum<string>

required

open until Patch's team answers it: planned, fixed or declined, with what they said in answer

Available options:

open,

planned,

fixed,

declined

answer

string | null

required

What Patch's team said

created_at

string

required

answered_at

string | null

required

follow_up

object | null

required

On a new report, the one thing that would make it much more useful, if it's missing: answer it with add_to and that field. Asked once.

Show child attributes

known

object | null

required

What Patch's team said about an earlier report on the same tool and error, when they have

Show child attributes

string

required

What to do now

Overview

Endpoints

Tell Patch's team what got in your way

Authorizations

Body

Response