Add an incident comment

Adds a message to the incident and returns the updated incident detail.

POST https://app.upfour.io/v1/incidents/{incidentID}/comments

A real request. Sending it changes data in your up4 account.

Authorization

AuthorizationA pls_ key. It stays in this browser tab. Needs incident.write.

Path

incidentIDpath · requiredPart of the request path.

Body

messagerequired

More fields1

notify Defaults to true. Set false to add the comment without sending the incident_comment notification to alert channels. The comment is saved and the live view in the app updates either way.

Headers

Idempotency-KeyheaderGenerated automatically when empty. How it works

Sent directly from your browser to https://app.upfour.io/v1. Mutating calls get an automatic Idempotency-Key when the field is empty.

Request

Responsenot sent yet

Fill in a key and press Send request (⌘↵).
The answer appears here.

scope incident.write stable Idempotency-Key supported returns 200

Parameters

Field	Type	Description
`incidentID` required	uuid	path parameter

Body

application/json required 2 fields

messagestringrequired

In the app: Post an update

All other fields1 fields

notifyboolean · nullable

Defaults to true. Set false to add the comment without sending the incident_comment notification to alert channels. The comment is saved and the live view in the app updates either way.

Returns

A successful request returns 200 with application/json.

Response fields 1 top-level fields

Field Type Description

data IncidentDetail

IncidentDetail · 60 fields

Field Type Description

acknowledged_at string (date-time) · nullable

cause string

check_method string

check_url string

client_id uuid · nullable

correlated_count integer

created_at string (date-time)

created_by string

description string

duration_seconds integer · nullable

escalation_target_label string

heartbeat_id uuid · nullable

heartbeat_name string

id uuid

metadata map of string · nullable max 100 keyseach value max length 4096 Custom key/value pairs (at most 100 keys; keys 1-128 characters, values up to 4096). Sent to machine-readable alert channels and API webhook subscriptions, and copied onto the incidents the resource opens.

monitor_id uuid · nullable

monitor_name string

notification_deliveries IncidentNotificationDelivery[] · nullable

Each item · 10 fields

Field	Type	Description
`attempt_count`	integer · nullable
`channel_name`	string
`created_at`	string (date-time)
`event_type`	string
`provider`	string
`status`	string one of`deliveredin_progresscancellednot_sentfailedunknown`
`channel_id`	uuid
`notice_kind`	string one of`initialreminderescalation`
`reason_code`	string one of`notification_policydo_not_disturbinitial_not_acceptednot_sent`
`reminder_number`	integer

notified_label string

override_channel_ids uuid[] · nullable

resolved_at string (date-time) · nullable

resolved_by_type string · nullable

resolved_by_user_id uuid · nullable

routing_target_id uuid · nullable

routing_type string one ofeveryoneescalation_policyteam

severity string one ofcriticalwarninginfo

started_at string (date-time)

started_by_type string

started_by_user_id uuid · nullable

status string one ofopenacknowledgedresolved

title string

updated_at string (date-time)

updates IncidentUpdate[] · nullable

Each item · 11 fields

Field	Type	Description
`actor_label`	string
`actor_type`	string
`actor_user_id`	uuid · nullable
`created_at`	string (date-time)
`event_type`	string
`id`	uuid
`incident_id`	uuid
`message`	string
`payload`	object · nullable free-form keys
`message_code`	string	Names a fixed system text of message so a client can translate it; empty for free text.
`message_params`	map of string	Values for the message_code text.

user_id uuid

escalation_target_channel_count integer

escalation_target_kind string one ofnobodychannel_countchannel_count_with_policyname

escalation_target_name string

notified_channel_count integer

notified_kind string one ofnobodydelivery_failedchannel_countchannel

Errors

Only the errors this operation can return. Every error uses the same envelope.

Status	Code	Meaning
400	`bad_request`	The request is malformed or fails validation.
404	`not_found`	The requested resource does not exist or is outside the caller's scope.
403	`permission_denied`	The credentials do not permit this action.

Every call can also return unauthorized (401), rate_limit_exceeded (429) or internal_error (500 / 502). See Responses and errors.

curl -s -X POST "https://app.upfour.io/v1/incidents/00000000-0000-4000-8000-000000000001/comments" \ -H "Authorization: Bearer $UP4_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "message": "Looking into the payment provider." }'

const res = await fetch("https://app.upfour.io/v1/incidents/00000000-0000-4000-8000-000000000001/comments", { method: "POST", headers: { Authorization: `Bearer ${process.env.UP4_API_KEY}`, "Content-Type": "application/json", }, body: JSON.stringify({ message: "Looking into the payment provider.", }), }); console.log(res.status, await res.json());

import os import requests res = requests.post( "https://app.upfour.io/v1/incidents/00000000-0000-4000-8000-000000000001/comments", headers={"Authorization": f"Bearer {os.environ['UP4_API_KEY']}"}, json={ "message": "Looking into the payment provider.", }, ) print(res.status_code, res.json())

package main import ( "fmt" "io" "net/http" "os" "strings" ) func main() { payload := strings.NewReader(`{ "message": "Looking into the payment provider." }`) req, _ := http.NewRequest("POST", "https://app.upfour.io/v1/incidents/00000000-0000-4000-8000-000000000001/comments", payload) req.Header.Set("Authorization", "Bearer "+os.Getenv("UP4_API_KEY")) req.Header.Set("Content-Type", "application/json") res, err := http.DefaultClient.Do(req) if err != nil { panic(err) } defer res.Body.Close() out, _ := io.ReadAll(res.Body) fmt.Println(res.StatusCode, string(out)) }

<?php $payload = <<<'JSON' { "message": "Looking into the payment provider." } JSON; $ch = curl_init("https://app.upfour.io/v1/incidents/00000000-0000-4000-8000-000000000001/comments"); curl_setopt_array($ch, [ CURLOPT_CUSTOMREQUEST => "POST", CURLOPT_RETURNTRANSFER => true, CURLOPT_HTTPHEADER => [ "Authorization: Bearer " . getenv("UP4_API_KEY"), "Content-Type: application/json", ], CURLOPT_POSTFIELDS => $payload, ]); $response = curl_exec($ch); echo curl_getinfo($ch, CURLINFO_RESPONSE_CODE), " ", $response, "\n"; curl_close($ch);

{ "data": { "acknowledged_at": "2026-10-27T09:00:00Z", "cause": "Reported manually", "check_method": "GET", "check_url": "https://example.com", "client_id": null, "correlated_count": 0, "created_at": "2026-10-27T09:00:00Z", "created_by": "anna@example.com", "description": "Response times above 2 seconds since 08:40.", "duration_seconds": 0, "escalation_target_kind": "name", "escalation_target_label": "Default escalation", "escalation_target_name": "Default escalation", "heartbeat_id": null, "heartbeat_name": "", "id": "00000000-0000-4000-8000-000000000001", "metadata": {}, "monitor_id": "00000000-0000-4000-8000-000000000002", "monitor_name": "Marketing website", "notification_deliveries": [], "notified_kind": "nobody", "notified_label": "Nobody", "override_channel_ids": [], "resolved_at": null, "resolved_by_type": null, "resolved_by_user_id": null, "routing_target_id": "00000000-0000-4000-8000-000000000003", "routing_type": "escalation_policy", "severity": "warning", "started_at": "2026-10-27T09:00:00Z", "started_by_type": "user", "started_by_user_id": "00000000-0000-4000-8000-000000000004", "status": "acknowledged", "title": "Checkout is slow", "updated_at": "2026-10-27T09:00:00Z", "updates": [ { "actor_label": "anna@example.com", "actor_type": "user", "actor_user_id": "00000000-0000-4000-8000-000000000004", "created_at": "2026-10-27T09:00:00Z", "event_type": "comment", "id": "00000000-0000-4000-8000-000000000005", "incident_id": "00000000-0000-4000-8000-000000000001", "message": "Looking into the payment provider.", "payload": {} }, { "actor_label": "anna@example.com", "actor_type": "user", "actor_user_id": "00000000-0000-4000-8000-000000000004", "created_at": "2026-10-27T09:00:00Z", "event_type": "escalation_target_acknowledged", "id": "00000000-0000-4000-8000-000000000006", "incident_id": "00000000-0000-4000-8000-000000000001", "message": "anna@example.com confirmed the manual escalation; the alert plan stopped", "payload": { "manual_escalation_id": "00000000-0000-4000-8000-000000000007", "source": "authenticated_user", "target_user_id": "00000000-0000-4000-8000-000000000004" } }, { "actor_label": "anna@example.com", "actor_type": "user", "actor_user_id": "00000000-0000-4000-8000-000000000004", "created_at": "2026-10-27T09:00:00Z", "event_type": "escalated", "id": "00000000-0000-4000-8000-000000000007", "incident_id": "00000000-0000-4000-8000-000000000001", "message": "Escalated to anna@example.com; the alert plan continues until they confirm", "payload": { "alert_plan_continues": true, "channel_ids": [ "00000000-0000-4000-8000-000000000008" ], "manual_escalation_id": "00000000-0000-4000-8000-000000000007", "manual_escalation_step": 1000001, "request_key": "walk-60", "status": "waiting_for_target_confirmation", "target_label": "anna@example.com", "target_user_id": "00000000-0000-4000-8000-000000000004" } }, { "actor_label": "anna@example.com", "actor_type": "user", "actor_user_id": "00000000-0000-4000-8000-000000000004", "created_at": "2026-10-27T09:00:00Z", "event_type": "created", "id": "00000000-0000-4000-8000-000000000009", "incident_id": "00000000-0000-4000-8000-000000000001", "message": "Incident reported manually.", "message_code": "incident_created_manual", "payload": {} } ], "user_id": "00000000-0000-4000-8000-000000000004" } }