CalDAV icon

CalDAV

CalDAV Node

Actions4

Overview

This node provides functionality to delete a calendar event using CalDAV protocol. It is useful in scenarios where you want to programmatically remove an event from a calendar, for example, when automating calendar management or synchronizing events between systems.

A practical example would be deleting an event that was previously fetched or created, by passing its metadata (including URL and etag) to ensure the correct event is targeted and concurrency control is maintained.

Properties

Name Meaning
Event Metadata The metadata of the event to delete, which includes the event's URL and etag. This is required and can be passed directly from a previous fetch operation's JSON metadata ($json.meta).

Output

The node outputs the result of the delete operation in the json output field. Typically, this will confirm whether the deletion was successful or provide relevant status information. There is no indication of binary data output for this operation.

Dependencies

  • Requires an API key credential for authenticating with the CalDAV service.
  • The node depends on the CalDAV server being accessible and properly configured.
  • No additional environment variables are explicitly required beyond the API authentication.

Troubleshooting

  • Common issues:

    • Providing incorrect or incomplete event metadata (missing URL or etag) will cause the deletion to fail.
    • Network connectivity problems or incorrect credentials will prevent successful communication with the CalDAV server.
    • Attempting to delete an event that does not exist or has already been deleted may result in errors.

  • Error messages and resolutions:

    • "Event metadata missing or invalid" — Ensure the event metadata JSON contains both URL and etag fields.
    • "Authentication failed" — Verify that the API key credential is correctly set up and valid.
    • "Event not found" — Confirm the event still exists on the server before attempting deletion.
    • "Concurrency error" — The etag might be outdated; fetch the latest event metadata before retrying.

Links and References

Discussion