Retry a job

POST 
/job/:id/retry

Create a new job using the same operation data as an existing job. The original job is preserved. Returns the new job ID.

Request

Path Parameters

id uuidrequired

UUID of the job to retry.

application/json

Body

target_hostname string

Override target hostname for the retried job. Defaults to _any if not specified.

Responses

201

The retry job was created successfully.

application/json

Schema

Schema

job_id uuidrequired

Unique identifier for the created job.

status stringrequired

Initial status of the job.

revision int64

The KV revision number.

timestamp string

Creation timestamp.

Example (from schema)

{
  "job_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "unprocessed",
  "revision": 1,
  "timestamp": "2025-06-14T10:00:00Z"
}

400

Invalid request parameters.

application/json

Schema

Schema

error string

A description of the error that occurred.

details string

Additional details about the error.

code integer

The error code.

Example (from schema)

{
  "error": "Failed to retrieve status.",
  "details": "Failed due to network timeout.",
  "code": 500
}

401

Unauthorized - API key required

application/json

Schema

Schema

error string

A description of the error that occurred.

details string

Additional details about the error.

code integer

The error code.

Example (from schema)

{
  "error": "Failed to retrieve status.",
  "details": "Failed due to network timeout.",
  "code": 500
}

403

Forbidden - Insufficient permissions

application/json

Schema

Schema

error string

A description of the error that occurred.

details string

Additional details about the error.

code integer

The error code.

Example (from schema)

{
  "error": "Failed to retrieve status.",
  "details": "Failed due to network timeout.",
  "code": 500
}

404

Job not found.

application/json

Schema

Schema

error string

A description of the error that occurred.

details string

Additional details about the error.

code integer

The error code.

Example (from schema)

{
  "error": "Failed to retrieve status.",
  "details": "Failed due to network timeout.",
  "code": 500
}

500

Error retrying job.

application/json

Schema

Schema

error string

A description of the error that occurred.

details string

Additional details about the error.

code integer

The error code.

Example (from schema)

{
  "error": "Failed to retrieve status.",
  "details": "Failed due to network timeout.",
  "code": 500
}

Loading...