> ## Documentation Index
> Fetch the complete documentation index at: https://docs.goes.health/llms.txt
> Use this file to discover all available pages before exploring further.

# Submit Feedback

> Submit feedback about the accuracy of a risk assessment response based on local knowledge or observations.

<Note type="warning">
  **Coming Soon** — This endpoint is under development and will be available at a future date.
</Note>

This endpoint allows you to submit feedback about the accuracy of a risk assessment response. For example, if you know there are no poison sumac plants in an area where the API indicated a risk, or if you've observed bears in an area where the API showed no risk.

## Request

### Headers

<ParamField header="Authorization" type="string" required>
  Your API key for authentication. Format: `Bearer YOUR_API_KEY`
</ParamField>

### Body

<ParamField body="responseId" type="string" required>
  The UUID of the risk assessment response you're providing feedback about. This is returned in the response of the `/v1/risks/environmental`, `/v1/risks/wildlife`, or `/v1/risks/plants` endpoints.
</ParamField>

<ParamField body="feedback" type="string" required>
  Your feedback about the accuracy of the risk assessment. Explain what risks you believe were incorrectly assessed and why. Include any local knowledge or observations that support your feedback.
</ParamField>

## Response

<ResponseField name="success" type="boolean">
  Indicates whether the feedback was successfully submitted.
</ResponseField>

<ResponseField name="message" type="string">
  A confirmation message indicating the feedback was received.
</ResponseField>

## Example

### Request

```bash theme={null}
curl -X POST "http://api.goes.health/v1/feedback" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "responseId": "123e4567-e89b-12d3-a456-426614174000",
    "feedback": "I am a local park ranger and can confirm there is no poison sumac in this area. The nearest occurrence is over 50 miles away in a different ecosystem."
  }'
```

### Response

```json theme={null}
{
  "success": true,
  "message": "Thank you for your feedback."
}
```


## OpenAPI

````yaml POST /v1/feedback
openapi: 3.1.0
info:
  title: GOES Health API
  description: API for accessing outdoor health risk data.
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://api.goes.health
security: []
paths:
  /v1/feedback:
    post:
      description: >-
        Submit feedback about the accuracy of a risk assessment response based
        on local knowledge or observations.
      parameters:
        - name: Authorization
          in: header
          description: Your API key for authentication.
          required: true
          schema:
            type: string
          example: Bearer your_api_key_here
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - responseId
                - feedback
              properties:
                responseId:
                  type: string
                  format: uuid
                  description: >-
                    The UUID of the risk assessment response you're providing
                    feedback about
                feedback:
                  type: string
                  description: >-
                    Your feedback about the accuracy of the risk assessment,
                    including any local knowledge or observations that support
                    your feedback
                  example: >-
                    I am a local park ranger and can confirm there is no poison
                    sumac in this area. The nearest occurrence is over 50 miles
                    away in a different ecosystem.
      responses:
        '200':
          description: Feedback submitted successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: true
                  message:
                    type: string
                    example: Thank you for your feedback.
        '400':
          description: Invalid request - missing or invalid parameters
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    example: Invalid responseId format

````