PingRoom

Trigger Quick Action

trigger_quick_action

Press a room quick action, notifying its members. Rate-limited. Read the action's input_type first (list_quick_actions): location needs data.location, link needs data.url, file/photo/pdf need attachment_ids — a press without the matching detail is a 422 quick_action_input_required.

Input Schema

TableJSON Schema

Name	Required	Description
`data`	No	The detail this press carries. data.location satisfies an action whose input_type is location; data.url satisfies link. Only these two keys are accepted on a trigger.
`ack_mode`	No	Confirmation rule for this press: any (default) resolves on the first confirmation; all waits for every original eligible recipient. Applies only when this press requires acknowledgement.
`is_urgent`	No	Deliver this one press time-sensitive so it breaks through Focus / Do Not Disturb and reaches members who muted the room or you (a block still wins). Send-time only — the action's saved configuration is unchanged.
`invite_code`	Yes	Room invite code.
`requires_ack`	No	Keep this one press open until an eligible recipient acknowledges it. Send-time only and elevating only: true adds the acknowledgement to an action that has none, false never disables the action's stored ack policy.
`action_number`	Yes	Quick-action slot number (1–16). Slots 5–16 require the room owner to have Pro.
`attachment_ids`	No	Ids of up to 4 uploaded attachments (see upload_attachment). Required when the action's input_type is file, photo (jpg/png only) or pdf (pdf only); a mismatched type is a 422 quick_action_input_type.
`trigger_source`	No	Defaults to "manual". Only these two are client-settable — "webhook" and "system" are stamped server-side and are rejected here.
`quick_action_id`	No	Optional id of the action as read from list_quick_actions. When the slot has since moved pages the press is refused with 409 quick_action_layout_changed instead of firing the wrong Ping.

Output Schema

TableJSON Schema

Name	Required	Description	Default
`result`	Yes	A privacy-minimized, chainable PingRoom notification result.

Schema Changelog

Changes observed during successful MCP inspections.

Changed1 schema field changedOct 11, 2026

addedOutput schema / properties / result / properties / checklist_state

Added value: +{
+  "description": "Present once an item of data.checklist is checked: ticks[] of {index, checked_at, checked_by.display_name}. A checked item stays checked.",
+  "type": "object"
+}

Changed3 schema fields changedSep 21, 2026

addedInput schema / properties / attachment_ids

Added value: +{
+  "description": "Ids of up to 4 uploaded attachments (see upload_attachment). Required when the action's input_type is file, photo (jpg/png only) or pdf (pdf only); a mismatched type is a 422 quick_action_input_type.",
+  "items": {
+    "format": "uuid",
+    "type": "string"
+  },
+  "maxItems": 4,
+  "type": "array"
+}

addedInput schema / properties / data

Added value: +{
+  "additionalProperties": false,
+  "description": "The detail this press carries. data.location satisfies an action whose input_type is location; data.url satisfies link. Only these two keys are accepted on a trigger.",
+  "properties": {
+    "location": {
+      "additionalProperties": false,
+      "description": "A shareable geographic location.",
+      "properties": {
+        "address": {
+          "description": "Optional formatted street address.",
+          "maxLength": 255,
+          "type": "string"
+        },
+        "label": {
+          "description": "Optional place name shown to the recipient.",
+          "maxLength": 100,
+          "type": "string"
+        },
+        "latitude": {
+          "description": "Latitude in decimal degrees.",
+          "maximum": 90,
+          "minimum": -90,
+          "type": "number"
+        },
+        "longitude": {
+          "description": "Longitude in decimal degrees.",
+          "maximum": 180,
+          "minimum": -180,
+          "type": "number"
+        }
+      },
+      "required": [
+        "latitude",
+        "longitude"
+      ],
+      "type": "object"
+    },
+    "url": {
+      "description": "An absolute http:// or https:// URL.",
+      "format": "uri",
+      "maxLength": 2048,
+      "type": "string"
+    }
+  },
+  "type": "object"
+}

addedInput schema / properties / quick_action_id

Added value: +{
+  "description": "Optional id of the action as read from list_quick_actions. When the slot has since moved pages the press is refused with 409 quick_action_layout_changed instead of firing the wrong Ping.",
+  "format": "uuid",
+  "type": "string"
+}

Changed1 schema field changedSep 16, 2026

changedInput schema / properties / is_urgent / description

Previous value: -"Deliver this one press time-sensitive so it breaks through Focus / Do Not Disturb. Send-time only — the action's saved configuration is unchanged."New value: +"Deliver this one press time-sensitive so it breaks through Focus / Do Not Disturb and reaches members who muted the room or you (a block still wins). Send-time only — the action's saved configuration is unchanged."

Changed2 schema fields changedSep 11, 2026

changedInput schema / properties / action_number / description

Previous value: -"Quick-action slot number (1–4)."New value: +"Quick-action slot number (1–16). Slots 5–16 require the room owner to have Pro."

changedInput schema / properties / action_number / maximum
```
Previous value: -4New value: +16
```

Changed1 schema field changedSep 10, 2026

addedInput schema / properties / ack_mode

Added value: +{
+  "description": "Confirmation rule for this press: any (default) resolves on the first confirmation; all waits for every original eligible recipient. Applies only when this press requires acknowledgement.",
+  "enum": [
+    "any",
+    "all"
+  ],
+  "type": "string"
+}

Changed1 schema field changedSep 1, 2026

addedOutput schema / properties / result / properties / origin_agent

Added value: +{
+  "description": "Present when a connected agent originated the ping: its handle and display name.",
+  "type": "object"
+}

First observedSep 1, 2026

TDQS

Score is being calculated.

All PingRoom tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources

Need Help?