feedback

Submit agent feedback

Record open-text feedback about an unexpected result, confusing behaviour, an error, or something you wish worked differently in the API, CLI or MCP server. Describe the situation, what you observed, and what you expected instead. If known, include the related tool, API operation or CLI command, the AI model and the agent harness. Do not include API keys, tokens, signed URLs or full file contents. Costs no credits and does not change your workspace.

POST/v1/feedback

Request

curl --request POST \
  --url 'https://api.ai-glot.com/v1/feedback' \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '{
  "observed_problem": "<string>",
  "situation": "<string>",
  "expected_solution": "<string>"
}'

import json
import requests

url = "https://api.ai-glot.com/v1/feedback"
headers = {
  "Authorization": "<api-key>",
  "Content-Type": "application/json"
}
payload = json.loads("{\"observed_problem\":\"<string>\",\"situation\":\"<string>\",\"expected_solution\":\"<string>\"}")

response = requests.request("POST", url, headers=headers, json=payload)
print(response.json())

const response = await fetch("https://api.ai-glot.com/v1/feedback", {
  method: "POST",
  headers: {
    "Authorization": "<api-key>",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "observed_problem": "<string>",
    "situation": "<string>",
    "expected_solution": "<string>"
  }),
});

const data = await response.json();
console.log(data);

<?php
$client = curl_init();

curl_setopt($client, CURLOPT_URL, "https://api.ai-glot.com/v1/feedback");
curl_setopt($client, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($client, CURLOPT_HTTPHEADER, [
    "Authorization: <api-key>",
    "Content-Type: application/json",
]);
curl_setopt($client, CURLOPT_POSTFIELDS, "{\"observed_problem\":\"<string>\",\"situation\":\"<string>\",\"expected_solution\":\"<string>\"}");
curl_setopt($client, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($client);
curl_close($client);
echo $response;

package main

import (
  "bytes"
  "fmt"
  "io"
  "net/http"
)

func main() {
  req, _ := http.NewRequest("POST", "https://api.ai-glot.com/v1/feedback", bytes.NewBuffer([]byte("{\"observed_problem\":\"<string>\",\"situation\":\"<string>\",\"expected_solution\":\"<string>\"}")))
  req.Header.Set("Authorization", "<api-key>")
  req.Header.Set("Content-Type", "application/json")
  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  data, _ := io.ReadAll(res.Body)
  fmt.Println(string(data))
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

var request = HttpRequest.newBuilder(URI.create("https://api.ai-glot.com/v1/feedback"))
    .header("Authorization", "<api-key>")
    .header("Content-Type", "application/json")
    .method("POST", HttpRequest.BodyPublishers.ofString("{\"observed_problem\":\"<string>\",\"situation\":\"<string>\",\"expected_solution\":\"<string>\"}"))
    .build();

var response = HttpClient.newHttpClient().send(
    request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

require 'net/http'
require 'json'

uri = URI("https://api.ai-glot.com/v1/feedback")
request = Net::HTTP::Post.new(uri)
request["Authorization"] = "<api-key>"
request["Content-Type"] = "application/json"
request.body = "{\"observed_problem\":\"<string>\",\"situation\":\"<string>\",\"expected_solution\":\"<string>\"}"

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == "https") do |http|
  http.request(request)
end

puts response.body

application/json

{
  "data": {
    "feedback_id": "<string>",
    "received": true
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>"
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>"
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>"
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>"
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>"
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>"
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>"
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>"
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>"
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>"
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>"
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>"
  },
  "request_id": "<string>"
}

Use this endpoint when an AI Glot tool, response, error or workflow behaves differently from what you expected, or when you wish something worked differently.

The request requires three open-text fields:

JSON{
  "observed_problem": "The response did not explain why the translation was rejected.",
  "situation": "I called the MCP translation tool with a valid file and a clear instruction.",
  "expected_solution": "The tool should name the exact missing or invalid input."
}

You may also include related_action (the tool, endpoint or command involved), ai_model and agent_harness. These fields are intentionally free text so an agent does not have to choose from a fixed catalogue.

The endpoint requires the same bearer authentication as the rest of the developer platform, but no additional scope. It does not read or modify workspace data and does not consume credits. AI Glot forwards the feedback directly as a structured event to its configured founder webhook.

Do not include API keys, tokens, signed URLs or full file contents.

Response

application/json

Submit feedback about using AI Glot

dataobjectrequired

Show child attributes

feedback_idstringrequired

receivedbooleanrequired

request_idstringrequired

curl --request POST \ --url 'https://api.ai-glot.com/v1/feedback' \ --header 'Authorization: <api-key>' \ --header 'Content-Type: application/json' \ --data '{ "observed_problem": "<string>", "situation": "<string>", "expected_solution": "<string>" }'

Submit agent feedback

Response

Use these docs with your AI tools

Query these docs via MCP

Query these docs over HTTP

Read these docs as Markdown