Back to Commands

retry

Retry a failed job using its reference ID. When a command fails, you can re-run it with the same parameters without typing the full command again.

Syntax

@Smart Workflow retry <request_id>

Examples

Retry a failed job
@Smart Workflow retry faf49ec7-b7f3-4dc7-aea8-323888098708
Copy the reference ID from the error message
@Smart Workflow retry abc12345-1234-5678-9abc-def012345678

How it works

1

Find reference ID

Copy the reference ID from the failed job's error message.

2

Lookup original job

Smart Workflow retrieves the original command and parameters.

3

Re-execute job

A new job is created with the same settings and queued for processing.

Finding the Reference ID

When a job fails, Smart Workflow includes a reference ID in the error message. This is the ID you'll use with the retry command.

Sorry, the `ship` command couldn't complete.

GitHub API rate limit exceeded. Please try again in a few minutes.

Reference: faf49ec7-b7f3-4dc7-aea8-323888098708

Copy the UUID from the reference line to use with the retry command.

When to use

Temporary failures

Rate limits, network timeouts, or API unavailability.

Transient errors

GitHub API errors that may resolve on retry.

Same parameters

When you want to re-run with identical settings.

⚠️ Important Notes

  • Request IDs expire after 24 hours—retry promptly after failures
  • The retry uses the exact same parameters as the original command
  • If you need different parameters, run a new command instead

💡 Pro Tips

  • Wait a few minutes before retrying rate limit errors
  • Smart Workflow automatically retries some transient errors up to 3 times before showing the failure
  • If the same error persists after retry, the issue may require a different approach