A small, authenticated API for sending and reading feedback from your own backend.
curl -X POST https://api.echo.builders/api/feedback \
-H "Authorization: Bearer echo_sk_your_secret_key" \
-H "Content-Type: application/json" \
-d '{"name": "Jane Smith", "feedback": "Love the product!"}'Every request is authenticated with an API key sent as a bearer token: Authorization: Bearer <key>. Echo issues two key types per project:
echo_sk_… — secret key, used to write feedback. Keep this server-side only.echo_pk_… — publishable key, used to read feedback. Safe to expose in client code.Creates a feedback entry for the authenticated project.
Requires the secret key.
Parameters
| Field | Type | Required | Description |
|---|---|---|---|
| name | string | Required | Reporter's name. |
| feedback | string | Required | The feedback content. |
| string | Optional | Reporter's email. | |
| rating | number | Optional | Star rating from 1 to 5. |
Request
curl -X POST https://api.echo.builders/api/feedback \
-H "Authorization: Bearer echo_sk_your_secret_key" \
-H "Content-Type: application/json" \
-d '{"name": "Jane Smith", "feedback": "Love the product!"}'Response
201{
"success": true,
"id": "fb_a1b2c3"
}Lists feedback entries for the authenticated project.
Requires the secret key.
Request
curl https://api.echo.builders/api/feedback \
-H "Authorization: Bearer echo_sk_your_secret_key"Response
200{
"feedback": [
{
"id": "fb_a1b2c3",
"name": "Jane Smith",
"feedback": "Love the product!",
"rating": 5,
"createdAt": "2026-06-24T10:00:00Z"
}
]
}| Status | Meaning |
|---|---|
| 400 | Invalid or malformed JSON request body. |
| 401 | Missing or invalid Bearer token. |
| 403 | Wrong key type, or the free plan's monthly limit was reached. |