record_marker

macOS

Purpose

Drops a named marker into the active recording's timeline. t_ms is elapsed ms since recording start. Provide bounds (global points, top-left) to zoom toward an element, or omit for full-frame. note becomes a caption source. Returns no_active_session if nothing is recording.

Required inputs

• name — Marker name, e.g. open_tray, act2_calendar_create.

Permissions and confirmation

No explicit confirmation parameter is exposed in this snapshot. This does not grant permission to act: obtain user authorization before any real action.

• Use only the apps, accounts and resources authorized by the user on this platform. Consult this tool's platform-specific description for its connection and permission requirements; this catalog does not assert additional OAuth scopes or OS entitlements.

{
  "properties": {
    "bounds": {
      "description": "Optional {x,y,w,h} global points to zoom toward.",
      "type": "object"
    },
    "name": {
      "description": "Marker name, e.g. open_tray, act2_calendar_create.",
      "type": "string"
    },
    "note": {
      "description": "Free text → caption source.",
      "type": "string"
    },
    "session_id": {
      "type": "string"
    }
  },
  "required": [
    "name"
  ],
  "type": "object"
}

Documentation example

Do not execute this example. These concrete inputs refer to a fictional demonstration dataset. Resolve real handles and obtain user authorization before any real call.

{
  "name": "Planning meeting"
}