Edit an existing log entry

:: services/logs/edit method

ID of the log entry to be edited. The user of your Access Token must be the author of the log entry.

New type of the log entry. This may be one of:

• Will attend, Attended or Comment for Event caches;
• Found it, Didn't find it or Comment for all other cache types.

For now, only the same five log types can be changed. If the log (before editing) is of another type, e.g. Available, the response will be success=false and an explanatory message. More log types may be editable in the future, so you MUST NOT rely on a success=false response for certain types.

If your user did recommend or rate the cache and the log type is changed from "Found it" or "Attended" to something else, the recommendation and rating will be withdrawn.

Some caches require a password in order to submit a "Found it" or "Attended" log entry. It must be supplied here if the log type is changed to "Found it" or "Attended". In all other cases, password is ignored.

You may check if this cache requires a password with req_passwd field of the services/caches/geocache method.

New text to store with the log entry; will replace the existing text. The comment_format must be supplied with the comment.

Note: Some OCPL-based sites support only BMP (Basic Multilingual Plane) Unicode characters on some database fields. If you submit characters from outside of the BMP plane (known as "supplementary planes", they include characters such as smiley symbols), then keep in mind that your text might be saved garbled.

Indicates the format of your comment, either html or plaintext.

Important note: The subset of allowed HTML elements is left undefined and may change in the future. For future-compatibility, you should use only basic formatting tags.

Same as in the services/logs/submit method, but without a default value.

Default value: unchanged

Confirms or changes the user's recommendation for the cache; one of the following:

• true - add a recommendation for the cache, if the user did not already recommend it. See the services/logs/submit method for more explanation,
• false - if the user recommended the cache, withdraw the recommendation,
• unchanged - no change of recommendation.

Default value: unchanged

If the user rated the cache, the option false will withdraw that rating. Otherwise, it will be ignored (which includes installations that do not provide geocache ratings; see the has_ratings field of services/caches/capabilities).

Default value: en

Pipe-separated list of ISO 639-1 language codes. This indicates the order of preference in which language will be chosen for error messages.