Feedback API

The Feedback API allows you to collect user feedback from any flows, specifically GraphQL APIs. This enables you to gather ratings, comments, and metadata about API responses, which can be viewed in the Reports section to improve your AI applications.

Overview

When executing flows via GraphQL API, you receive a requestId in the response. This requestId can be used to submit feedback about the flow execution, helping you track user satisfaction and identify areas for improvement.

Getting the Request ID

After executing a flow via GraphQL API, you’ll receive a requestId in the response. This unique identifier is used to associate feedback with a specific flow execution.

{
  "data": {
    "executeWorkflow": {
      "requestId": "your_request_id",
      "status": "success",
      "result": { ... }
    }
  }
}

Authentication

To submit feedback, you’ll need to include your API key in the request headers:

Authorization: Bearer your_api_key

You’ll also need to include your project ID:

x-project-id: your_project_id

Submit Feedback

The submitFeedback mutation allows you to submit feedback for a specific flow execution.

Request Parameters

Response Fields

Code Examples

cURL

curl -X POST \
  https://sandbox566-acridxylophone.lamatic.dev/graphql \
  -H "Authorization: Bearer ${LAMATIC_API_KEY}" \
  -H 'Content-Type: application/json' \
  -H 'x-project-id: 93628611-e45c-4895-a807-7e6f950b295c' \
  -d '{
    "query": "mutation SubmitFeedback($requestId: String!, $rating: Int, $comment: String, $metadata: JSON) { submitFeedback(requestId: $requestId, rating: $rating, comment: $comment, metadata: $metadata) { success message data error } }",
    "variables": {
      "requestId": "your_request_id",
      "rating": 5,
      "comment": "Great response!",
      "metadata": {
        "source": "api",
        "user_id": "123"
      }
    }
  }'

Node.js

const axios = require('axios');

// Export your Lamatic API key as an environment variable
const lamatic_api_key = process.env.LAMATIC_API_KEY;

const query = `
  mutation SubmitFeedback(
    $requestId: String!
    $rating: Int
    $comment: String
    $metadata: JSON
  ) {
    submitFeedback(
      requestId: $requestId
      rating: $rating
      comment: $comment
      metadata: $metadata
    ) {
      success
      message
      data
      error
    }
  }
`;

const variables = {
  requestId: "your_request_id",
  rating: 5,
  comment: "Great response!",
  metadata: {
    source: "api",
    user_id: "123"
  }
};

const options = {
  method: 'POST',
  url: 'YOUR_PROJECT_ENDPOINT',
  headers: {
    Authorization: `Bearer ${lamatic_api_key}`,
    'Content-Type': 'application/json',
    'x-project-id': 'YOUR_PROJECT_ID',
  },
  data: { query, variables }
};

axios(options)
  .then(response => console.log(response.data))
  .catch(error => console.error(error));

Python

import os
import requests

# Export your Lamatic API key as an environment variable
lamatic_api_key = os.getenv('LAMATIC_API_KEY')

gqlQuery = """
  mutation SubmitFeedback(
    $requestId: String!
    $rating: Int
    $comment: String
    $metadata: JSON
  ) {
    submitFeedback(
      requestId: $requestId
      rating: $rating
      comment: $comment
      metadata: $metadata
    ) {
      success
      message
      data
      error
    }
  }
"""

variables = {
  "requestId": "your_request_id",
  "rating": 5,
  "comment": "Great response!",
  "metadata": {
    "source": "api",
    "user_id": "123"
  }
}

data = {"query": gqlQuery, "variables": variables}

headers = {
  "Authorization": f"Bearer {lamatic_api_key}",
  "Content-Type": "application/json",
  "x-project-id": "YOUR_PROJECT_ID"
}

url = "YOUR_PROJECT_ENDPOINT"

response = requests.post(url, headers=headers, json=data)

if response.status_code == 200:
    print(response.json())
else:
    print(f"Error: {response.status_code}")
    print(response.text)

Response Example

Success Response

{
  "data": {
    "submitFeedback": {
      "success": true,
      "message": "Feedback submitted successfully",
      "data": null,
      "error": null
    }
  }
}

Error Response

{
  "data": {
    "submitFeedback": {
      "success": false,
      "message": "Failed to submit feedback",
      "data": null,
      "error": "Invalid requestId"
    }
  }
}

Viewing Feedback

After submitting feedback, you can view all collected feedback in the Reports section of your Lamatic dashboard. The reports provide insights into:

• User ratings and satisfaction levels
• Comments and textual feedback
• Metadata associated with feedback submissions
• Trends and patterns over time

This data helps you identify areas for improvement and track the quality of your AI applications.