External Services

Repoint a service's continuous archive source

Deliberately, explicitly moves where a service's continuous, standing archiving process writes: Postgres/Timescale's WAL-G archive_command, or MariaDB's binlog shipper. Both need everything written under one S3 prefix to stay restorable — data archived before this call lives under the previous source and will no longer be verifiable or replayable once archiving points at the new one.

This exists because a backup schedule that requests a different S3 source than the one archiving is currently pinned to is refused, not silently honoured (see ExternalServiceManager::repoint_continuous_archive_source for the incident this prevents). Call this endpoint to deliberately move the pin instead — for example, to switch a service from an operator's own S3 source onto Temps Cloud's managed one.

post/external-services/{id}/continuous-archive-source

Request

  • Base URL: /api (relative, and the document was published on a file host, not at the API’s origin)
  • URL: /api/external-services/{id}/continuous-archive-source
  • Auth: none declared

Path parameters

idinteger required

External service ID

Request body

new_s3_source_idinteger required

The S3 source continuous archiving should point at from now on.

Response

Continuous archive source repointed

continuous_archive_pinned_atstring required
continuous_archive_s3_source_idinteger required
service_idinteger required

Changes

No recorded changes to this operation across all 50 revisions of this API.