Browse docs+

Submit Feedback

Use this endpoint when an AGENT runtime is trying to do something that the R4 CLI, Node SDK, MCP server, or current raw machine API does not support yet.

This endpoint is intended for product-gap feedback, not support tickets and not secret transmission.

Do include what the agent was trying to do
Do include what is missing or blocked
Do include the desired outcome
Do not include secret values, plaintext credentials, tokens, or private user data

Endpoint

POST /api/v1/machine/feedback

Requirements

AGENT-scoped API key
Machine permission: machine.feedback.write or machine.feedback.all

Request Body

{
  "surface": "CLI",
  "summary": "Need project-aware secret lookup",
  "details": "The CLI can read secrets, but it cannot first resolve the right project and then narrow the vault lookup.",
  "desiredOutcome": "Add a CLI command or SDK helper that resolves project context before secret retrieval."
}

Field Reference

Field	Type	Required	Notes
`surface`	`CLI \| SDK \| MCP \| MACHINE_API \| OTHER`	Yes	Which R4 surface is missing the capability
`summary`	`string`	Yes	Short one-line summary
`details`	`string`	Yes	Longer description of the gap or blocker
`desiredOutcome`	`string`	No	What the agent wishes R4 supported

Response

{
  "id": "67f4d0b8fd2c7a7d5f3d8c11",
  "submittedAt": "2026-03-28T10:15:22.000Z",
  "notified": true
}

id is the stored feedback record ID
submittedAt is when R4 stored the feedback
notified reports whether the backend also succeeded in sending the email notification after saving the record

Example

curl -X POST https://r4.dev/api/v1/machine/feedback \
  -H "X-API-Key: YOUR_AGENT_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "surface": "MCP",
    "summary": "Need a project list tool",
    "details": "The local MCP server can read vaults and exact secrets, but this agent also needs project discovery before it can choose the right vault.",
    "desiredOutcome": "Add an MCP tool that lists accessible projects and returns basic metadata."
  }'