v1Recursos/Locations/postProgramar el archivado de una ubicación
Programar el archivado de una ubicación
PROGRAMA el archivado de una ubicación al final del periodo de facturación actual. La ubicación permanece totalmente activa, facturable, y sigue contando contra el límite de ubicaciones del plan hasta entonces — no se elimina nada, y programarla no libera espacio para añadir otra ubicación hasta que realmente se archive. Llama a cancel-archive para cancelarlo antes de que se produzca, o a reactivate después para recuperar la ubicación.
post
locations:write/api/v1/locations/{id}/archiveParámetros de consulta
idstringobligatorio
La ubicación a programar para el archivado.
Respuesta
dataobjectopcional
scheduledbooleanopcional
Siempre true en caso de éxito.
scheduledArchiveAtstringopcional
Fecha en que se solicitó el archivado (también el token que usa cancel-archive para identificarlo), como marca de tiempo ISO 8601, o null si no hay ninguno pendiente.
archiveAtstringopcional
Cuándo se producirá realmente el archivado programado — el límite de facturación de la agencia. Null si la agencia no tiene ninguno.
Errores
401La clave de API falta, es inválida, expiró o fue revocada.
403A la clave le falta el permiso requerido, o no está autorizada para este cliente/ubicación.
404El recurso no se encontró, o no pertenece a su agencia.
409La solicitud entra en conflicto con el estado actual del recurso — por ejemplo, cambiar el correo electrónico o el teléfono de un destinatario al que ya se le ha enviado un mensaje, o una invitación de equipo que ya fue aceptada (o que aún no ha sido aceptada).
429Demasiadas solicitudes. Reintente tras el número de segundos indicado en el encabezado Retry-After.
post/api/v1/locations/{id}/archive
Su clave de API
id *
{
"data": {
"scheduled": true,
"scheduledArchiveAt": "2026-02-01T00:00:00.000Z",
"archiveAt": "2026-03-01T00:00:00.000Z"
}
}Guías que usan este endpoint
- How to Manage Business Listings ProgrammaticallyKeep business listings accurate from your own system with the Synup API. Covers change detection, idempotent updates, hours, photos and sync reporting.
- Temporarily Close a Business Location via APIMark a location closed for a holiday or a renovation with specialHours, and why you must not use archival for a temporary closure.