Submit Rating - Danube

curl -X POST "https://api.danubeai.com/v1/ratings" \
  -H "danube-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "tool_id": "tool_abc123",
    "rating": 5,
    "comment": "Works great, fast and reliable"
  }'

from danube import DanubeClient

with DanubeClient(api_key="dk_...") as client:
    # Rating via SDK (if available)
    result = client.tools.rate(
        tool_id="tool_abc123",
        rating=5,
        comment="Works great, fast and reliable",
    )

import { DanubeClient } from 'danube';

const client = new DanubeClient({ apiKey: 'dk_...' });
const result = await client.tools.rate({
  toolId: 'tool_abc123',
  rating: 5,
  comment: 'Works great, fast and reliable',
});

{
  "tool_id": "tool_abc123",
  "rating": 5,
  "comment": "Works great, fast and reliable",
  "created_at": "2026-02-24T12:00:00Z"
}

POST

ratings

curl -X POST "https://api.danubeai.com/v1/ratings" \
  -H "danube-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "tool_id": "tool_abc123",
    "rating": 5,
    "comment": "Works great, fast and reliable"
  }'

from danube import DanubeClient

with DanubeClient(api_key="dk_...") as client:
    # Rating via SDK (if available)
    result = client.tools.rate(
        tool_id="tool_abc123",
        rating=5,
        comment="Works great, fast and reliable",
    )

import { DanubeClient } from 'danube';

const client = new DanubeClient({ apiKey: 'dk_...' });
const result = await client.tools.rate({
  toolId: 'tool_abc123',
  rating: 5,
  comment: 'Works great, fast and reliable',
});

{
  "tool_id": "tool_abc123",
  "rating": 5,
  "comment": "Works great, fast and reliable",
  "created_at": "2026-02-24T12:00:00Z"
}

Overview

Submit a star rating (1-5) for a tool with an optional comment. If you’ve already rated this tool, your existing rating is updated. Auth: Requires authentication (JWT or API key).

Body Parameters

tool_id

string

required

The UUID of the tool to rate

rating

integer

required

Rating from 1 to 5

comment

string

default:""

Optional text comment about the tool

Response

tool_id

string

The rated tool UUID

rating

integer

The submitted rating (1-5)

comment

string

The submitted comment

created_at

string

ISO 8601 timestamp

Example

curl -X POST "https://api.danubeai.com/v1/ratings" \
  -H "danube-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "tool_id": "tool_abc123",
    "rating": 5,
    "comment": "Works great, fast and reliable"
  }'

from danube import DanubeClient

with DanubeClient(api_key="dk_...") as client:
    # Rating via SDK (if available)
    result = client.tools.rate(
        tool_id="tool_abc123",
        rating=5,
        comment="Works great, fast and reliable",
    )

import { DanubeClient } from 'danube';

const client = new DanubeClient({ apiKey: 'dk_...' });
const result = await client.tools.rate({
  toolId: 'tool_abc123',
  rating: 5,
  comment: 'Works great, fast and reliable',
});

{
  "tool_id": "tool_abc123",
  "rating": 5,
  "comment": "Works great, fast and reliable",
  "created_at": "2026-02-24T12:00:00Z"
}

MCP Tool

This endpoint is also available as the submit_rating MCP tool:

result = await mcp.call_tool("submit_rating", {
    "tool_id": "tool_abc123",
    "rating": 5,
    "comment": "Works great"
})

Get Tool Ratings Get My Rating

​Overview

​Body Parameters

​Response

​Example

​MCP Tool

Overview

Body Parameters

Response

Example

MCP Tool