---
title: "Report a problem with this API"
method: POST
path: "/feedback"
tags: ["Feedback"]
---

# Report a problem with this API

`POST /feedback`

## Request

- Base URL: `https://api.getfacade.ai/api/v1`
- URL: `https://api.getfacade.ai/api/v1/feedback`
- Auth: one of:
  - HTTP bearer
  - OAuth 2 (authorization code, authorization URL `https://api.getfacade.ai/oauth/authorize`, token URL `https://api.getfacade.ai/oauth/token`, scopes: `agent`)

Something wrong with the API itself: a field documented here but never sent, a refusal
whose wording leaves no way forward, a call that only works on the second try, a result
that does not match what was asked for.

Free, and accepted on an empty wallet, so the refusal that just happened can be reported
while it is still in hand. Rate-limited to 10 an hour. Nobody replies through this
endpoint; what comes back is a reference to quote. Questions about an account or a charge
need a person and belong on the support form instead.

Identity is taken from the key, so no name or address is asked for.

## Request body

- object
  - `data` object
    - `type` 'feedback'
    - `attributes` object
      - `message` string, required: What was attempted, what was expected, what happened instead.
      - `category` 'bug_report' | 'feature_request' | 'technical_support'
      - `context` object: Whatever identifies the case. Every field optional.
        - `tool` string
        - `endpoint` string
        - `status_code` integer
        - `job_id` string
        - `expected` string
        - `actual` string

## Response `201`

Report recorded

- object
  - `data` object
    - `type` 'feedback'
    - `id` string
    - `attributes` object
      - `reference` string: Quote this when following up.
      - `message` string

## Other responses

- `401`: The key is missing, revoked or expired. Re-issuing a key is a human action.
- `422`: The request was understood and refused. The message is the API's own text; show it unchanged. `IDEMPOTENCY_KEY_REQUIRED` — a paid call from an agent key with no `Idempotency-Key` header; nothing was queued, send it again with one. `IDEMPOTENCY_KEY_REUSED` — that header value already names a different request; a new order needs a new value.
- `429`: Rate limited on this key's own bucket, separate from the human sessions of the same account. Refusal is deliberately cheap: back off, do not retry in a tight loop.

---

[API](https://skmtc.dev/getfacade/apis/getfacade-agent-api.md) · [All operations](https://skmtc.dev/getfacade/apis/getfacade-agent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/getfacade/apis/getfacade-agent-api/revisions/2b52eda7362c?raw)