/api/v1/mentions/:id
Update mention status
Endpoint
- Method:
POST - Path:
/api/v1/mentions/:id
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. |
Request body
Required: Yes
application/json
Schema: MentionStatusUpdateRequest
Example:
{
"commentStatus": 1
}Responses
200: Mention status updated successfully.
- Content-Type:
application/json - Schema:
MentionStatusUpdateResponse - Example:
{
"id": 2001,
"commentStatus": 1,
"commentStatusAt": "2026-03-24T02:00:00.000Z"
}400: Invalid mention ID or invalid commentStatus value.
- Content-Type:
application/json - Schema:
ErrorResponse - Example:
{
"error": "commentStatus must be 1 or -1"
}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 or invalid commentStatus value.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.
