Referencia · reminders
Borrar recordatorio
/reminders/{id} Requiere el scope reminders:write.
Los mismos que GET (mismo 404 opaco); en un proyecto archivado responde 409 project_archived.
En un recordatorio recurrente scope es obligatorio: sin él responde 409 recurring_scope_required y no borra nada. occurrence quita solo el día occurrenceKey (queda en excludedKeys); series lo borra entero.
Parámetros de ruta
idstringobligatorioId del recordatorio.
Parámetros de query
scopestringSolo para recordatorios recurrentes.
occurrenceKeystringDía que se quita,
YYYY-MM-DDen la zona horaria de quien lo creó. Obligatorio conscope=occurrence; hoy o después, y un día en que el recordatorio ocurre (422si no).
Respuestas
204
Recordatorio borrado (o el día quitado). Sin cuerpo.
401
Key ausente, malformada, inexistente, revocada, expirada o API deshabilitada (invalid_api_key, indistinguibles a propósito).
403
Scope insuficiente (insufficient_scope), recurso sin acceso (forbidden) o sincronización de calendario de una tarea que creó otra persona (calendar_creator_only).
404
Recurso inexistente, de otro usuario o id malformado (not_found, indistinguibles a propósito).
409
Tarea o recordatorio recurrente sin ?scope=occurrence|series (recurring_scope_required) o proyecto archivado (project_archived). No se borró nada.
422
Entrada inválida (invalid_json, unknown_field, missing_field, invalid_field, invalid_query_param, empty_patch, body_too_large — cuerpos de más de 64 KB —, invalid_idempotency_key, validation_error, y al asignar assignee_not_member, task_not_shared, task_private, share_pending).
429
Límite superado (rate_limited) — 60 req/min (ráfagas de 20) y 5.000 req/día por key. Reintentar tras Retry-After.
500
Error interno (internal_error). Cuerpo opaco a propósito; reintentar con backoff.