Feedback - Snow Leopard

curl --request POST \
  --url https://api.snowleopard.ai/v1/instances/{instance_id}/feedback \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data @- <<EOF
{
  "feedbackText": "The revenue column in the orders table should be labeled 'gross revenue before discounts', not 'net revenue'.",
  "datasourceId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "schemaId": "<string>"
}
EOF

{
  "ok": true,
  "feedbackId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "gateStatus": "raw",
  "truncated": true
}

{
  "__type__": "apiError",
  "callId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "responseStatus": "<string>",
  "description": "<string>"
}

{
  "__type__": "apiError",
  "callId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "responseStatus": "<string>",
  "description": "<string>"
}

{
  "__type__": "apiError",
  "callId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "responseStatus": "<string>",
  "description": "<string>"
}

{
  "__type__": "apiError",
  "callId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "responseStatus": "<string>",
  "description": "<string>"
}

POST

instances

{instance_id}

feedback

curl --request POST \
  --url https://api.snowleopard.ai/v1/instances/{instance_id}/feedback \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data @- <<EOF
{
  "feedbackText": "The revenue column in the orders table should be labeled 'gross revenue before discounts', not 'net revenue'.",
  "datasourceId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "schemaId": "<string>"
}
EOF

{
  "ok": true,
  "feedbackId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "gateStatus": "raw",
  "truncated": true
}

{
  "__type__": "apiError",
  "callId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "responseStatus": "<string>",
  "description": "<string>"
}

{
  "__type__": "apiError",
  "callId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "responseStatus": "<string>",
  "description": "<string>"
}

{
  "__type__": "apiError",
  "callId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "responseStatus": "<string>",
  "description": "<string>"
}

{
  "__type__": "apiError",
  "callId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "responseStatus": "<string>",
  "description": "<string>"
}

Use the Feedback API endpoint to teach Snow Leopard about your business logic, column definitions, and terminology. Feedback can be given at any time, in plain text, and is processed asynchronously to improve future query accuracy for your instance.

Python

from snowleopard import SnowLeopardClient

client = SnowLeopardClient(api_key="{api_key}")
response = client.feedback(
    instance_id="{instance_id}",
    feedback_text="The revenue column should be labeled 'gross revenue before discounts'."
)

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <api_key>. API keys are created per instance in Snow Leopard Cloud.

Path Parameters

instance_id

string

required

Unique identifier for the instance

Body

application/json

feedbackText

string

required

Plain-text description of the correction. Maximum 2000 characters; longer values are silently truncated and the response will include truncated: true.

Example:

"The revenue column in the orders table should be labeled 'gross revenue before discounts', not 'net revenue'."

datasourceId

string<uuid>

UUID of the target data source. Takes priority over schemaId when both are provided. Recommended for instances with multiple data sources.

schemaId

string

Schema identifier for the target data source (e.g. 'northwind'). Available as the schemaId field in /retrieve and /response results. Used when datasourceId is not provided. If neither field is supplied, feedback is applied to the first connected data source.

Response

Feedback accepted and queued for processing

enum<boolean>

required

Always true for a 202 response.

Available options:

true

feedbackId

string<uuid>

required

Unique identifier for the submitted feedback

gateStatus

enum<string>

required

Acknowledgment state at submission time. Always 'raw'. Snow Leopard processes feedback asynchronously; there is no polling endpoint to track status changes.

Available options:

raw

truncated

boolean

Only present when feedbackText exceeded 2000 characters and was silently truncated to fit.

Response Getting Started