Sources

A source describes where a project worker can find backups. It references secret metadata from the same project; credential values are not sent to this API.

Create a source

Send project_id, name, service_type, protocol, domain, port, and secret_id. Supported source types are s3, ftp, sftp, and smb.

• S3 uses http or https and also requires region, bucket, and s3_addressing_style.
• FTP uses ftp.
• SFTP uses sftp.
• SMB uses smb and requires the share name in bucket.

The referenced secret must be active, belong to the same project, and have the matching service type.

Lifecycle constraints

You can update connection metadata, the linked secret, or status. A source referenced by a schedule cannot be paused or deleted. Source type is immutable; create a replacement source when the type changes.

List filters support name, endpoint, kind, and status.

Endpoint reference

• Create a source
• List sources
• Get source details
• Update a source
• Delete a source

Required scopes are v1.sources:read, v1.sources:write, and v1.sources:delete.