List Replication Tasks
List recent replication task attempts for a bucket you own.
| Endpoint | Method | Admin Required |
|---|---|---|
/api/v1/buckets/:bucketName/replication/tasks | GET | No |
Lists the bucket's most recent replication task attempts (both still-pending and dead-lettered failed rows), most-recent-first, capped at 100. See Replication for the retry/backoff behavior these tasks follow.
Successfully replicated tasks aren't listed here - a task row only exists while it's pending its first attempt or retrying, and is removed as soon as it succeeds.
Path Parameters
bucketName
string required
The name of the bucket.
Response
{
"tasks": [
{
"id": "1a2b3c4d-0000-0000-0000-000000000000",
"ruleId": "1a2b3c4d-1111-0000-0000-000000000000",
"targetId": "6ff08747-4ec0-48fd-a0b1-f5adda6d3161",
"endpoint": "https://remote.example.com",
"key": "uploads/photo.jpg",
"versionId": "abc123",
"operation": "put",
"state": "failed",
"attempts": 8,
"nextAttemptAt": "2026-07-02T16:27:42.503Z",
"lastError": "connection refused",
"createdAt": "2026-07-02T15:27:42.503Z"
}
]
}
Response Fields
id
string
The task's id - pass this to Retry Replication Task to requeue it.
ruleId
string
The replication rule that enqueued this task. Kept for display only - not re-resolved, so it stays informative even if the rule is later edited or removed.
targetId
string
The replication target this task is delivering to. Kept for display only, same reasoning as
ruleId.endpoint
string
The target endpoint - snapshotted at the time the task was queued, so it stays accurate (and keeps working) even if the target has since changed or been removed.
key
string
The object key being replicated.
versionId
string
The source object version this task refers to. For
put tasks this is exactly what gets replicated; for delete tasks it's informational only (see Replication for why deletes aren't replicated by version id).operation
string
put or delete.state
string
pending (still retrying) or failed (retries exhausted, dead-lettered).attempts
integer
Number of delivery attempts made so far.
nextAttemptAt
string
When the next retry is scheduled (only meaningful while
state is pending).lastError
string
The reason the most recent attempt failed.
null if no attempt has failed yet.createdAt
string
When the task was originally queued.
Errors
| Status | Reason |
|---|---|
400 | Missing bucket name |
404 | Bucket not found (or not owned by you) |