Manage Scheduled Jobs

Once you have set up scheduled jobs, managing them is straightforward. This guide covers how to monitor, edit, pause, and optimize your active schedules.

View All Your Scheduled Jobs

Access Your Schedules Dashboard

1. Open your workflow
2. Click the Scheduling tab
3. You see a list of all your active, paused, and completed schedules

The dashboard shows:

• Schedule name: What you named it
• Status: Active, Paused, Completed, or Failed
• Next run: When it will run next (for active schedules)
• Last run: When it most recently ran
• Frequency: Once, Daily, Weekly, Hourly, etc.
• Quick actions: Pause, Resume, Edit, Delete buttons

Filter and Sort Your Schedules

• Filter by status: Show only Active, Paused, Completed, or Failed
• Sort by: Next run time, last run time, or frequency
• Search: Find a schedule by name

Edit Schedule Timing and Configuration

You can change most aspects of a schedule without starting over.

Editable Elements

• Schedule name: Rename your schedule anytime
• Frequency: Change from Daily to Weekly, adjust timing, etc.
• Time of day: Change from 9am to 5pm, etc.
• Rows to process: Update filters or switch from "all rows" to "filtered rows"
• Timezone: Change if your team moves or for multi-region support

What You Cannot Edit

• Workflow associated: The workflow being scheduled does not change
• Once vs. Interval mode: You cannot switch a one-time schedule to recurring (delete and recreate instead)

How to Edit a Schedule

1. Click the Edit button next to your schedule (or click the schedule name)
2. The schedule form opens with current settings
3. Change what you need
4. Click Save Changes
5. The schedule updates immediately (takes effect on the next run)

Important: Editing takes effect on the next scheduled run, not immediately. If you want to test changes, manually run the workflow first.

Pause Schedules Temporarily

When to Pause

• You are troubleshooting a problem with your workflow
• You want to make changes without the schedule running
• You are doing maintenance or updates
• You need to stop processing temporarily

How to Pause

Click the Pause button next to your schedule. It stops running at its next scheduled time.

What happens when you pause:

• Current execution (if running) completes normally
• No new executions start
• Schedule stays in your list with "Paused" status
• You can resume anytime

Tip: Pausing is temporary. If you want to remove a schedule permanently, use the Delete button instead.

Resume Paused Schedules

How to Resume

Click the Resume button next to your paused schedule.

What happens when you resume:

• Schedule becomes "Active" again
• Next execution runs at the next scheduled time (not immediately)
• All settings remain the same as before pausing

Example:

• You pause a daily 9am schedule on Wednesday
• You resume it on Friday
• It next runs at 9am Friday (not immediately when you click Resume)

Tip: Resuming does not execute immediately. It waits for the next scheduled time. If you want to test immediately, manually run your workflow instead.

Delete Schedules

How to Delete

Click the Delete button next to your schedule.

You see a confirmation: "Are you sure? This cannot be undone."

Click Yes, Delete to confirm.

What happens:

• Schedule is removed from your list
• It no longer runs
• Cannot be recovered

Warning: Deletion is permanent. Pause first if you are unsure.

When to Delete

• You no longer need this enrichment
• You have merged schedules
• You are consolidating workflows
• The workflow no longer exists

Understand Schedule Execution History

View Execution Logs

Click on a schedule name to open the Execution History tab.

You see a list of every time this schedule has run (or attempted to run):

What Each Status Means

Review Individual Run Details

Click on any execution to see:

• Exact start/end times
• Number of rows processed
• API calls made: Which external services were queried
• Error details: Specific error messages if something went wrong
• Log output: Step-by-step execution log

Monitor Schedule Health

Key Health Indicators

1. Consistency

• Is your schedule running at expected times?
• Look at the "Last Run" column. It should match when you expect.

2. Success Rate

• Are most runs "Success" or are you seeing many "Failed"?
• Occasional failures are normal. Frequent failures indicate a problem.

3. Execution Time

• Is each run taking longer than before?
• Sudden slowdown might mean your workflow needs optimization or your data has grown.

4. Error Patterns

• Same error repeatedly? That is a clue.
• Different errors each time? Might be an environmental issue (API flakiness).

Health Checks to Run Monthly

1. Review the last 10 runs: Do they all show Success?
2. Check execution times: Are they within the expected range?
3. Spot-check one result: Click into a recent execution log to verify data looks correct
4. Update as needed: Adjust timing or filters based on what you find

What Happens When a Scheduled Enrichment Fails?

Automatic Retry Behavior

TexAu automatically retries failed jobs. If all retries fail, the job is marked as "Failed."

Manual Retry

If a job is stuck in "Failed" status:

1. Click on the failed schedule
2. Look at the execution history
3. Click Retry next to the failed execution (if available)
4. Or click Pause, review your workflow, then Resume

Common Failure Causes and Solutions

Tip: Set up notifications (if available) so you are alerted to repeated failures instead of discovering them weeks later.

Tips for Efficient Scheduling

1. Start Conservative, Scale Up Gradually

• Start with daily schedules
• Monitor results for a week
• If working well, increase frequency
• Do not jump to hourly without understanding the impact

2. Use Filters to Process Only Relevant Rows

Instead of processing all rows daily, filter to only rows where created_date = today. This runs faster and costs less.

3. Stagger Your Schedules

If you have multiple schedules, do not run them all at 9am. Spread them out:

• Daily enrichment: 9am
• Weekly refresh: 8pm Sunday
• Hourly check: Every hour on the hour

This prevents all jobs from running simultaneously.

4. Monitor Execution Times

Keep an eye on how long each execution takes:

• 1 minute: Very efficient
• 5 to 10 minutes: Normal
• 30+ minutes: Investigate (might need optimization)

5. Combine Multiple Operations

Instead of creating multiple separate workflows and schedules, combine related operations into a single workflow with one schedule.

6. Document Your Schedules

Keep a simple record of your schedules:

7. Use Clear Names

Instead of "Schedule 1" or "My Workflow," use names like "Daily Lead Enrichment for Sales" or "Weekly Company Database Refresh."

Troubleshoot Common Issues

Schedule Is Not Running

1. Is the status "Active" (not Paused)?
2. Is the current time past the scheduled time?
3. Check execution history. Did the job run? (It might have succeeded already.)
4. If it is recurring, is today a day it should run? (A Weekly Monday schedule does not run on Tuesday.)

Schedule Is Running But Results Look Wrong

1. Open the execution log and verify which rows were processed
2. Manually run the workflow with the same rows to verify
3. Check if your data filters are correct
4. Review formulas and processing actions for errors

Scheduled Job Takes Longer Than Expected

1. Is your data set growing? (More rows = longer execution)
2. Did your workflow change? (New processing steps = more time)
3. Are external APIs slow? (Check their status pages)
4. Try reducing the number of rows processed at once (use filters)

Getting Repeated "Failed" Status

1. Review the error message in execution logs
2. Is the issue with your workflow (formula error) or external (API down)?
3. Pause the schedule, fix the issue, then resume
4. Test your workflow manually before resuming the automated schedule

---

What's Next?

• Need to set up a new schedule? Setting Up Scheduled Jobs
• Want to build more complex workflows? Formula Basics
• Need to clean data first? Built-in Processing Actions