Cancel CRM Lead Calendar event

This page documents the canonical HTTP contract for this endpoint.

Conditional availability: these routes require CALENDAR_INTEGRATION_ENABLED=true; otherwise they return 404. Use a signed-in user session or a developer API key with the listed Calendar scope. Access uses the key owner’s own connected personal calendar in the current workspace. Calendar OAuth consent is separate from email consent. Credentials are never returned.

Only the organizer may cancel a CRM-matched event. Read the exact event first and send expected_etag from the reviewed response. Recurring-series deletion is unsupported. The provider sends cancellation notices; deleting a local CRM activity alone is a different action.

Command Center reads additionally respect CALENDAR_AGENT_READ_ENABLED; agent writes require CALENDAR_AGENT_ENABLED=true. HTTP and CLI availability do not by themselves prove that the harness adapter is enabled. Use capability discovery for the deployed surface.

Path parameters

providerrequired
string
google or microsoft; use a connected account from the connections response.
event_idrequired
string
Exact provider-issued event ID. URL-encode it when constructing a path; never reconstruct it from a title.

Name	Type	Description
providerrequired	string	google or microsoft; use a connected account from the connections response.
event_idrequired	string	Exact provider-issued event ID. URL-encode it when constructing a path; never reconstruct it from a title.

Query parameters

expected_etag · optional
string
Exact etag from the most recent event read. A mismatch returns 409; read and review again.

Name	Type	Description
expected_etag	string	Exact etag from the most recent event read. A mismatch returns 409; read and review again.

Errors

Status	Meaning
400	Invalid range or provider state, reconnect required, CRM match missing, or event not editable.
401	Authentication required.
403	The key lacks the required Calendar scope.
404	Calendar is disabled, the connection is unavailable, or the event is not found.
409	Event version changed; read and review again.
422	Invalid request fields.
502	Calendar provider request failed.

Example

bash

curl -X DELETE "https://app.autotouch.ai/api/calendar/google/events/event_example" \
  -H "Authorization: Bearer $AUTOTOUCH_API_KEY"

Response example

json

{
  "id": "event_example",
  "provider": "google",
  "deleted": true,
  "lead_id": "lead_example"
}