> ## Documentation Index > Fetch the complete documentation index at: https://docs.maple.inc/llms.txt > Use this file to discover all available pages before exploring further. # Send feedback > Tells Maple about a bug, a missing capability, wrong docs, or an error you could not act on. Cite the `request_ids` involved so we can see what you sent. Maple copies its request history for ids it recognizes and keeps any other id as given, so a report is never refused over an id. Any credential may send feedback; no scope is required. Each app may send 20 per environment per hour; beyond that the API answers 429 with `Retry-After`. Maple reads feedback every week. Nothing changes automatically when you send it, and you get no reply through the API. This contract will not break: fields and `kind` values may be added, never removed, renamed, or made required. ## OpenAPI ````yaml /openapi/developer-api.json post /feedback openapi: 3.1.0 info: title: Maple Developer API version: 0.0.1 description: >- Public API for POS and platform partners to integrate with Maple: granted locations and connections, the order loop (validation, notification, accept/deny, status updates), payment-link visibility, menu publishing, and HMAC-signed webhooks. Authenticate every request with a Bearer API key (`mpk_test_…` / `mpk_live_…`). The credential determines the environment: test-mode credentials only see test data, live-mode credentials only see live data. servers: - url: https://api.maple.inc/v1 description: Production - url: https://api.staging.maple.inc/v1 description: Sandbox (development and testing) security: [] tags: - name: General description: Service status and credential introspection. - name: Locations description: The restaurant locations your app has been granted access to. - name: Connections description: Become (or stop being) a granted location’s order receiver. - name: Menu description: Publish and read a connected location’s menu. - name: Delivery zones description: >- Manage a connected location’s delivery zones and check whether a coordinate is deliverable. - name: Orders description: 'The order loop: read orders, submit validation results, and decide orders.' - name: Bookings description: >- Bookings (rolling out per location): a location’s booking profile, availability, holds, bookings, walk-ins, venue verbs, configuration, and live floor. - name: Waitlist description: >- A Maple-native location’s walk-up waitlist: the queue and wait estimate, joining, and venue actions. - name: Webhooks description: Event-type catalog, subscriptions, the event ledger, and replay. - name: Feedback description: >- Tell Maple about a bug, a missing capability, wrong docs, or an error you could not act on. paths: /feedback: post: tags: - Feedback summary: Send feedback description: >- Tells Maple about a bug, a missing capability, wrong docs, or an error you could not act on. Cite the `request_ids` involved so we can see what you sent. Maple copies its request history for ids it recognizes and keeps any other id as given, so a report is never refused over an id. Any credential may send feedback; no scope is required. Each app may send 20 per environment per hour; beyond that the API answers 429 with `Retry-After`. Maple reads feedback every week. Nothing changes automatically when you send it, and you get no reply through the API. This contract will not break: fields and `kind` values may be added, never removed, renamed, or made required. operationId: developer-api-feedback.createFeedback parameters: [] requestBody: content: application/json: schema: type: object properties: kind: type: string enum: - bug - missing_capability - docs_wrong - unclear_error - other description: >- `bug`: the API did something wrong. `missing_capability`: you needed something the API cannot do. `docs_wrong`: the docs or reference disagree with the API. `unclear_error`: an error did not tell you what to change. `other`: anything else. summary: type: string allOf: - pattern: ^\S[\s\S]*\S$|^\S$|^$ - minLength: 1 - maxLength: 200 - pattern: ^[^\u0000]*$ - pattern: ^[^\u0000-\u001F\u007F-\u009F\u2028\u2029]*$ description: One line, at most 200 characters. attempted: anyOf: - type: string allOf: - pattern: ^\S[\s\S]*\S$|^\S$|^$ - minLength: 1 - maxLength: 4000 - pattern: ^[^\u0000]*$ - type: 'null' description: >- What you were trying to do, as a goal (for example, "seat a walk-in party of four"). Leave it out when the feedback is not about a task. expected: anyOf: - type: string allOf: - pattern: ^\S[\s\S]*\S$|^\S$|^$ - minLength: 1 - maxLength: 4000 - pattern: ^[^\u0000]*$ - type: 'null' description: What you expected the API to do. observed: anyOf: - type: string allOf: - pattern: ^\S[\s\S]*\S$|^\S$|^$ - minLength: 1 - maxLength: 4000 - pattern: ^[^\u0000]*$ - type: 'null' description: What the API did instead. endpoint: anyOf: - type: string allOf: - pattern: ^\S[\s\S]*\S$|^\S$|^$ - minLength: 1 - maxLength: 200 - pattern: ^[^\u0000]*$ - type: 'null' description: >- The method and path this is about, for example `POST /v1/waitlist_entries`. request_ids: anyOf: - type: array items: type: string allOf: - pattern: ^\S[\s\S]*\S$|^\S$|^$ - minLength: 1 - maxLength: 200 - pattern: ^[^\u0000]*$ allOf: - maxItems: 10 - type: 'null' description: >- Up to ten ids of the requests this is about, usually the `x-request-id` response header. Maple copies what its request history holds for ids this app made in this environment in the last seven days; any other id is kept as you sent it. required: - kind - summary additionalProperties: false required: true responses: '200': description: Success content: application/json: schema: type: object properties: object: type: string enum: - feedback id: type: string livemode: type: boolean created: anyOf: - anyOf: - type: number - type: string enum: - NaN - type: string enum: - Infinity - type: string enum: - '-Infinity' - type: string enum: - Infinity - '-Infinity' - NaN kind: type: string enum: - bug - missing_capability - docs_wrong - unclear_error - other summary: type: string request_ids: type: array items: type: string status: type: string enum: - received required: - object - id - livemode - created - kind - summary - request_ids - status additionalProperties: false '400': description: DeveloperApiBadRequest content: application/json: schema: anyOf: - $ref: '#/components/schemas/DeveloperApiBadRequest' - $ref: '#/components/schemas/DeveloperApiBadRequest' '401': description: DeveloperApiUnauthorized content: application/json: schema: $ref: '#/components/schemas/DeveloperApiUnauthorized' '429': description: DeveloperApiRateLimited content: application/json: schema: anyOf: - $ref: '#/components/schemas/DeveloperApiRateLimited1' - $ref: '#/components/schemas/DeveloperApiRateLimited' headers: Retry-After: description: >- Seconds to wait before retrying; also returned as retry_after in the body. schema: type: integer minimum: 1 security: - bearer: [] components: schemas: DeveloperApiBadRequest: type: object properties: _tag: type: string enum: - DeveloperApiBadRequest code: type: string message: type: string feedback: type: string description: Where to report this error if it does not tell you what to change. required: - _tag - message - feedback additionalProperties: false DeveloperApiUnauthorized: type: object properties: _tag: type: string enum: - DeveloperApiUnauthorized message: type: string feedback: type: string description: Where to report this error if it does not tell you what to change. required: - _tag - message - feedback additionalProperties: false DeveloperApiRateLimited1: type: object properties: _tag: type: string enum: - DeveloperApiRateLimited message: type: string retry_after: anyOf: - anyOf: - type: number - type: string enum: - NaN - type: string enum: - Infinity - type: string enum: - '-Infinity' - type: string enum: - Infinity - '-Infinity' - NaN feedback: type: string description: Where to report this error if it does not tell you what to change. required: - _tag - message - retry_after - feedback additionalProperties: false DeveloperApiRateLimited: type: object properties: _tag: type: string enum: - DeveloperApiRateLimited message: type: string retry_after: anyOf: - type: number - type: string enum: - NaN - type: string enum: - Infinity - type: string enum: - '-Infinity' feedback: type: string description: Where to report this error if it does not tell you what to change. required: - _tag - message - retry_after - feedback additionalProperties: false securitySchemes: bearer: type: http scheme: bearer description: >- API key — `mpk_test_…` for the sandbox, `mpk_live_…` for production. Issued by Maple during partner onboarding. ````