Update dive
logbook_update_diveUpdate an existing PADI logbook dive by changing only the fields you provide. Use null to clear optional fields; Pending, Verified, or QR Code Verified dives are locked.
Instructions
Change a dive in the PADI logbook. Only the fields you pass change; null clears an optional field (title, date, location and dive_type cannot be cleared). Same fields, values and units as logbook_create_dive. Numbers are in the call's units (see units): depth and visibility in m or ft, temperatures in degrees C or F, weight in kg or lb, cylinder size in litres or cubic feet, pressures in bar or psi, times in minutes. Dives that are Pending, Verified or QR Code Verified are locked: they cannot be changed or deleted. Returns the updated dive.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"dive_id": "<dive_id>"
},
"name": "logbook_update_dive"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| gas | No | Breathing gas: Air (Air (21% oxygen)), Enriched_32 (Nitrox EANx32 (32% oxygen)), Enriched_36 (Nitrox EANx36 (36% oxygen)), Enriched_40 (Nitrox EANx40 (40% oxygen)), Enriched (Nitrox, other mix), Trimix, Rebreather. "EAN32" or "nitrox 32" means Enriched_32. Air and EANx32/36/40 fill the percentages; Enriched, Trimix and Rebreather need oxygen_pct (and helium_pct for Trimix), summing to 100 with nitrogen (null clears it) | |
| date | No | Dive date YYYY-MM-DD (a calendar date, not in the future, at most 100 years ago) | |
| suit | No | Exposure suit: NoExposure (No exposure suit), FullSuit_3mm (3 mm full wetsuit), FullSuit_5mm (5 mm full wetsuit), FullSuit_7mm (7 mm full wetsuit), Shorty, SemiDrySuit, DrySuit. "3mm" means FullSuit_3mm (null clears it) | |
| notes | No | Notes (free text) (null clears it) | |
| surge | No | Surge: SomeSurge (Light surge), MediumSurge, BigSurge (Strong surge). "strong" means BigSurge; "none" means no surge (null clears it) | |
| title | No | New title | |
| units | No | Units of the numbers in this call and its answer: auto (the PADI logbook setting), metric (m, degrees C, bar, kg, litres) or imperial (ft, degrees F, psi, lb, cubic feet). Default: the server setting. | |
| waves | No | Waves: NoWaves, SmallWaves, MediumWaves, LargeWaves (null clears it) | |
| skills | No | Training dives only: the skills done (replaces the list) (null clears it). Open (flexible skills): "no skills", "cramp removal", "snorkel exchange", "tube deployment", "weight drop", "swim compass", "diver tow", "remove scuba", "remove weights", and for dives 2-4 also "controlled ascent", "compass navigation" ("no skills" when none was done). Rescue (exercises): "tired diver", "panicked diver", "responsive diver", "distressed diver underwater", "missing diver", "surfacing the unresponsive diver", "unresponsive diver at the surface", "exiting the unresponsive diver", "first aid for pressure", "unresponsive diver". Reactivate (requirements): "mask flood", "panicked diver", "weight drop", "alternate air", "log dive" ("panicked diver" is PADI's value of the "buoyancy / weight check" item). Specialty: one free-text entry (the specialty). Advanced and DSD dives store no skills. Open, Rescue and Reactivate dives need at least one before verification | |
| status | No | Publish (a finished dive, the default) or Draft (an unfinished dive: depth and time not needed) | |
| weight | No | Weight carried, in kg (metric) or lb (imperial) (null clears it) | |
| buddies | No | Buddies (one free-text field, for example "Sam, Kim") (null clears it) | |
| current | No | Current: NoCurrent, SomeCurrent (Light current), MediumCurrent, StrongCurrent. "light" means SomeCurrent (null clears it) | |
| dive_id | Yes | The dive id (from logbook_list_dives) | |
| feeling | No | How the dive felt: Amazing, Good, Average, Poor (null clears it) | |
| time_in | No | Time in, HH:MM (not verified with PADI yet; PADI's web app does not show it) (null clears it) | |
| weather | No | Weather: Sunny, Partly Cloudy, Cloudy, Rainy, Windy, Foggy (null clears it) | |
| air_temp | No | Air temperature, in C (metric) or F (imperial) (null clears it) | |
| location | No | New location | |
| time_out | No | Time out, HH:MM (not verified with PADI yet; PADI's web app does not show it) (null clears it) | |
| dive_type | No | Dive type: Boat, BeachShore (Shore), Other. "shore" and "beach" mean BeachShore | |
| equipment | No | Extra equipment, for example ["Hood", "Gloves", "Boots"] (PADI offers these three; other items are allowed). Replaces the whole list (null clears it) | |
| max_depth | No | Maximum depth, in m (metric) or ft (imperial). Needed unless the dive is a Draft (null clears it) | |
| helium_pct | No | Helium in %, 0-100 (default 0) (null clears it) | |
| oxygen_pct | No | Oxygen in %, 0-100 (whole numbers) (null clears it) | |
| visibility | No | Visibility: High (Good (high)), Average, Low (Poor (low)) (null clears it) | |
| water_type | No | Water: Salt (Salt water), Fresh (Fresh water) (null clears it) | |
| dive_center | No | Dive center or operator (free text) (null clears it) | |
| weight_type | No | How the weighting felt: Light (Too light), Good, Heavy (Too heavy) (null clears it) | |
| end_pressure | No | Cylinder pressure at the end, in bar (metric) or psi (imperial) (null clears it) | |
| nitrogen_pct | No | Nitrogen in %, 0-100 (default: the rest to 100) (null clears it) | |
| body_of_water | No | Body of water: Ocean, Lake, Quarry, River, Other (null clears it) | |
| cylinder_size | No | Cylinder size: litres of water volume (metric) or cubic feet (imperial, converted the way the PADI web app does) (null clears it) | |
| cylinder_type | No | Cylinder material: Steel, Aluminum (Aluminium), Other (null clears it) | |
| adventure_dive | No | Adventure dive (Advanced elective dives 7-9): Deep Diving, Underwater Navigation, Altitude Diving, Boat Diving, Digital Underwater Imaging, Drift Diving, Dry Suit Diving, Fish Identification, Night Diving, Peak Performance Buoyancy, Search and Recovery, Rescue, Underwater Naturalist, Wreck Diving, Adaptive Support Diver, Cavern Diving, Delayed Surface Marker Buoy Dive, Dive Against Debris Diver (AWARE), Diver Propulsion Vehicle (DPV), Enriched Air Diver, Full Face Mask Diver, Ice Diver, Rebreather Diver, Self-Reliant Diver, Shark Conservation Dive(AWARE), Sidemount Diver (null clears it) | |
| start_pressure | No | Cylinder pressure at the start, in bar (metric) or psi (imperial) (null clears it) | |
| bottom_time_min | No | Bottom time in whole minutes. Needed unless the dive is a Draft (null clears it) | |
| bottom_water_temp | No | Water temperature at depth, in C (metric) or F (imperial) (null clears it) | |
| surface_water_temp | No | Water temperature at the surface, in C (metric) or F (imperial) (null clears it) | |
| visibility_distance | No | Visibility distance, in m (metric) or ft (imperial) (null clears it) |