> ## Documentation Index > Fetch the complete documentation index at: https://alguna.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Send feedback > Sends product feedback about the Alguna API to the Alguna team. Use it when a response is missing a field you needed, an error does not say how to recover, a capability you looked for does not exist, or the documentation led you astray. Name the operation it concerns and say what you tried, what you expected and what happened. The call changes no data. ## OpenAPI ````yaml /api-reference/v2/specs/2026-04-01.json post /feedback openapi: 3.1.0 info: title: Alguna Public API version: '2026-04-01' servers: - url: https://api.alguna.io x-fern-server-name: Production security: - bearerAuth: [] tags: - name: Billing Events and Metrics - name: Checkout Sessions - name: Credit Notes - name: Credits - name: Customer Portal Sessions - name: Customers - name: Feedback - name: Insights - name: Integrations - name: Invoices - name: Merchants - name: Payments - name: Plans - name: Product Bundles - name: Products - name: Quotes - name: Refunds - name: Revenue Schedules - name: Subscription Changes - name: Subscription Versions - name: Subscriptions - name: Tags - name: Tax - name: Users - name: Wallet Grants - name: Wallets paths: /feedback: post: tags: - Feedback summary: Send feedback description: >- Sends product feedback about the Alguna API to the Alguna team. Use it when a response is missing a field you needed, an error does not say how to recover, a capability you looked for does not exist, or the documentation led you astray. Name the operation it concerns and say what you tried, what you expected and what happened. The call changes no data. operationId: create-feedback parameters: - in: header name: Alguna-Version required: true schema: enum: - '2026-04-01' type: string - in: header name: Idempotency-Key schema: description: >- A unique string that makes a retried write safe. If you send the same request with the same key within 24 hours, the API returns the stored response and does not run the request again. A 5xx or 429 response is not stored, so a retry with that key runs the request again. example: ik_a1b2c3d4e5f6 maxLength: 255 type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/CreateFeedbackRequest' required: true responses: '200': content: application/json: schema: $ref: '#/components/schemas/FeedbackResponse' description: Success headers: Idempotency-Key: description: Echo of the idempotency key provided in the request schema: type: string Idempotent-Replayed: description: >- Whether this response was replayed from a previous request (true) or freshly executed (false) schema: type: boolean '400': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: Bad Request '401': content: application/json: schema: oneOf: - $ref: '#/components/schemas/ErrorResponse' - $ref: '#/components/schemas/GatewayErrorResponse' description: Unauthorized '403': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: Forbidden — the organization does not have access to this feature '404': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: Not Found '409': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: >- Conflict — a request with this idempotency key is currently being processed headers: Retry-After: description: >- Seconds to wait before retrying with the same idempotency key. Sent only when a request with this key is still being processed; a 409 without it is a conflict that a retry will not resolve. schema: type: integer '422': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: Unprocessable Entity '500': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: Internal Server Error '502': description: >- Bad Gateway — sent by the infrastructure in front of the API; the body is not JSON. Safe to retry. '503': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: >- Service Unavailable — a dependency is temporarily unavailable. Retry with backoff. '504': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: >- Gateway Timeout — the request did not finish in time. Retry with backoff; use an idempotency key for writes. components: schemas: CreateFeedbackRequest: properties: category: description: >- What the feedback is about: a response that lacked something you needed, an error that did not say how to recover, a capability you could not find, documentation that misled you, a slow call, praise, or anything else. enum: - response - error-message - missing-capability - documentation - performance - praise - other example: missing-capability type: string feedback: description: >- The feedback itself: what you tried, what you expected and what happened. Do not include credentials or customer data. example: >- I need to filter invoices by due date, but list-invoices only filters by issue date. maxLength: 2000 minLength: 1 type: string operation: description: Operation ID of the endpoint the feedback is about, if there is one. example: list-invoices maxLength: 100 type: string required: - category - feedback type: object FeedbackResponse: properties: received: description: True when the Alguna team has received the feedback example: true type: boolean required: - received type: object ErrorResponse: description: The body of every error the API returns. properties: detail: description: Explanation of what went wrong type: string status: description: HTTP status code of the response format: int64 type: integer title: description: >- HTTP status text. Sent only by version, idempotency and credit-refusal errors. type: string type: description: Always `about:blank`. Sent only by version and idempotency errors. type: string required: - status - detail type: object GatewayErrorResponse: description: >- Returned by the API gateway when a request carries no valid API key, before the API handles it. properties: code: description: Machine-readable error code, e.g. `unauthenticated` type: string details: nullable: true type: object message: description: Explanation of what went wrong type: string required: - code - message type: object securitySchemes: bearerAuth: bearerFormat: API Key description: API key authentication. Pass your API key as a Bearer token. scheme: bearer type: http x-fern-bearer: env: ALGUNA_API_KEY name: apiKey ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.