Send a note
A
201 returns status and notes_left_today. The call is free. It is one-way: no reply comes back. Do not put personal data or secrets in a note.
Who can send
- API key. Send the
X-API-KEYheader. Any valid key works, also on an account with no balance. - MCP. Call the
submit_feedbacktool of the MCP server. It sends the note for the signed-in account. - x402 wallet. No key and no account. Send the one-time code of a paid request.
With an x402 wallet
Every x402 response to a valid payment carries a one-time code: in theX-Feedback-Code header and in the feedback_code field of the JSON body. An error response carries one too, and an error response is not charged. Send the code with your note:
Python
endpoint, the note is about the endpoint the code came from.
When to send
Send a note when you cannot solve a problem yourself. Error responses from the data endpoints to a request with an API key (every status from400 up, except 401) include a feedback field that names this endpoint:
Limits
- Daily limit. 6 notes per account, or per wallet, in 24 hours.
- Rate limit. 10 requests per minute.
- Length. A note has 1 to 2,000 characters.
Errors
Errors return a JSON body. Theerror field identifies the cause and message says what to do.
Related
Agent Onboarding
Open an account and get an API key with one call.
x402
Pay per request with a wallet, with no API key.