Activities

Update an activity

Tick it off, jot a journal note, price it, pin it, categorise it or move its time. Only the fields given change; the instant (at_utc) is re-derived.

patch/api/experiences/{id}

Request

  • Base URL: https://trvlrr.app
  • URL: https://trvlrr.app/api/experiences/{id}
  • Auth: HTTP bearer

Path parameters

idstring required

The id.

Request body

namestring

What it is.

kind'restaurant' | 'place' | 'activity' | 'note'

restaurant, place, activity or note.

citystring nullable

City.

countrystring nullable

Country (name or ISO code).

notestring nullable

A note about it.

ratinginteger nullable

1–5, for places already visited.

doneboolean

Done.

journalstring nullable

A journal entry about it.

price_rawstring nullable

Price with currency.

latnumber nullable

Latitude (set with lon).

lonnumber nullable

Longitude (set with lat).

categorystring nullable

restaurant, cafe, bar, attraction, museum, tour, concert, theatre, sport, nature, beach, spa, shopping, meeting, parking or place.

tzstring nullable

IANA time zone.

at_utcstring nullable

Derived; only set to override.

datestring nullable

Date, YYYY-MM-DD.

timestring nullable

Local time "HH:MM".

remind_onstring nullable

A day to be reminded about it. Date, YYYY-MM-DD. null clears it.

remind_timestring nullable

Time of day for the reminder, "HH:MM" local; empty means 09:00.

payment_status'paid' | 'due' | 'on_arrival' | 'null' nullable

paid, due (to pay before the trip) or on_arrival (pay there or on the day).

payment_method'card' | 'cash' | 'null' nullable

card or cash.

Response

The activity after the change.

idstring required
trip_idstring required
kind'restaurant' | 'place' | 'activity' | 'note' required
namestring required
citystring nullable required
latnumber nullable required
lonnumber nullable required
datestring nullable required

Date, YYYY-MM-DD.

ratinginteger nullable required
notestring nullable required
created_bystring nullable required
created_atstring required
timestring nullable required

Local time "HH:MM".

price_rawstring nullable required
booked_atstring nullable required
doneinteger required

0 or 1.

journalstring nullable required
categorystring nullable required
planning_statestring nullable required
countrystring nullable required

ISO alpha-2.

cancellation_statestring nullable required
cancelled_reasonstring nullable required
tzstring nullable required
at_utcstring nullable required
remind_onstring nullable

Date, YYYY-MM-DD.

remind_timestring nullable

"HH:MM"; empty means 09:00.

payment_statusstring nullable
payment_methodstring nullable

Changes

No recorded changes to this operation across all 1 revision of this API.