/api/v1/mentions/:id/comment
Generate or re-generate mention comment
Endpoint
- Method:
PUT - Path:
/api/v1/mentions/:id/comment
Base URL
https://api.mentionkit.com
Authentication
Use Authorization: Bearer YOUR_API_KEY.
Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| id | path | Yes | integer | Mention ID. |
Responses
200: Comment generated successfully.
- Content-Type:
application/json - Schema:
MentionItem - Example:
{
"id": 2001,
"platform": "REDDIT",
"keywordValue": "example alternative",
"projectId": 3001,
"subreddit": "saas",
"authorHandle": "user_123",
"text": "Looking for alternatives to ExampleMonitor for social listening.",
"lang": "en",
"sourceCreatedAt": "2026-03-20T10:15:00.000Z",
"createdAt": "2026-03-20T10:15:02.000Z",
"relevance": -1,
"relevanceText": null,
"comment": "I tested three tools and saved the best threads in one doc, that made follow ups easier each day.",
"commentStatus": 1,
"platformPostId": "p_abc123",
"redditPostId": "rp_abc123",
"redditCommentId": "rc_def456"
}400: Invalid mention ID.
- Content-Type:
application/json - Schema:
ErrorResponse - Example:
{
"error": "Invalid mention id"
}401: Missing or invalid API key.
- Content-Type:
application/json - Schema:
ErrorResponse - Example:
{
"error": "Invalid API key"
}403: API access blocked. The organization is deactivated for API usage and must have an active trial, active paid subscription, or billing exemption.
- Content-Type:
application/json - Schema:
ErrorResponse - Example:
{
"error": "API access requires a trial, paid subscription, or billing exemption"
}404: Mention not found for this organization.
- Content-Type:
application/json - Schema:
ErrorResponse - Example:
{
"error": "Mention not found"
}500: Unexpected server error.
- Content-Type:
application/json - Schema:
ErrorResponse
Error codes
400: Invalid mention ID.401: Missing or invalid API key.403: API access blocked. The organization is deactivated for API usage and must have an active trial, active paid subscription, or billing exemption.404: Mention not found for this organization.500: Unexpected server error.
