Skip to main content
POST
/
api
/
alerts
/
{alertId}
/
comments
cURL
curl -X POST "https://app.cotool.ai/api/alerts/:alertId/comments" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"bodyMarkdown":"string"}'
{
  "entry": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "organizationId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "alertId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "createdAt": "<string>",
    "actorUserId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "actorAgentId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "actorRunId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "actorUserName": "<string>",
    "actorUserImageUrl": "<string>",
    "kind": "<string>",
    "bodyMarkdown": "<string>",
    "metadata": {
      "source": {},
      "originDetectionHitId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "originTriggerId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "sourcePayloadId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
    },
    "actorAgentName": "<string>"
  }
}

Authorizations

​
Authorization
string
header
required

API Key authentication for programmatic access. Include your API key in the Authorization header as: Bearer your_api_key_here

Path Parameters

​
alertId
string
required

Alert UUID or human-readable display ID

Body

application/json
​
bodyMarkdown
string
required

Markdown comment body

Required string length: 1 - 20000

Response

Successful response

​
entry
object
required