For the complete documentation index, see llms.txt
Saltar al contenido principal
Version: 1.0

PushFeedback API

The PushFeedback REST API lets you read the feedback collected for your projects and drive the same endpoints the feedback widget uses under the hood.

Base URL: https://app.pushfeedback.com

Authentication

Endpoints that read or change your data require an API key sent in the Authorization header:

Authorization: Api-Key <your-api-key>

API keys are scoped to a team, and can optionally be restricted to a single project of that team. Every key holds one or more scopes:

ScopeAllows
feedback:readList a project's feedback
feedback:submitSubmit feedback to projects that require a submit key
project:manageUpdate project settings, such as the site URL

A key can hold any combination of scopes; pick them when creating the key in the dashboard.

Requests for a project the key does not cover, either because the project belongs to another team or falls outside the key's project restriction, return 404 Not Found, so a leaked key cannot be used to probe which project identifiers exist. Requests that the key's scopes do not allow on a project it does cover return 403 Forbidden with a message naming the missing scope.

Getting an API key

Team admins can create and revoke API keys from the team settings page on app.pushfeedback.com. The full key is shown once, at creation time; store it securely. Official PushFeedback integrations may provision keys automatically.

The endpoints the widget calls on page load and on submit, such as retrieving the project configuration and submitting feedback, are public and need no API key by default. Projects can opt in to requiring a key for feedback submission; see the submit endpoint.

Versioning

The API is versioned. All endpoints live under /api/v1/.

Rate limits

Public endpoints are rate limited per client IP. If you exceed a limit, the API responds with 429 Too Many Requests.

Authentication

Team API key, sent as Authorization: Api-Key <your-api-key>. Note the Api-Key prefix before the key itself. Keys hold one or more scopes (feedback:read, feedback:submit, project:manage) and may be restricted to one project.

Security Scheme Type:

apiKey

Header parameter name:

Authorization