Viewing execution history

Track past agent runs, review results, and analyze performance

Last updated: Oct 4, 2025

Every time you run an agent, ConvertMate keeps a record of what happened. Your execution history lets you review past results, track what agents you've used, understand credit usage, and identify which agents provide the most value.

Accessing execution history

To view your past agent executions:

  1. Log in to your ConvertMate account
  2. Click AI Agents in the left sidebar
  3. Select Past executions from the submenu
  4. You'll see a chronological list of all agent runs
View your execution history

Understanding the executions list

Each execution in your history shows:

Agent name - Which agent ran. Status - Whether it completed, failed, is still running, or was canceled. Date and time - When the execution started. Duration - How long it took to complete. Credits used - The exact credit cost for that execution. Scope - How many items were processed (products, pages, etc.). Quick preview - A summary of key results or changes.

The list shows your most recent executions first, with the newest at the top.

Execution statuses

Executions can have these statuses:

Completed - The agent finished successfully. You can view full results. Running - The agent is currently executing. You can check progress or cancel it. Failed - The agent encountered an error and stopped. Credits are automatically refunded. Canceled - You manually stopped the execution. Unused credits are refunded. Partial - The agent completed but some items couldn't be processed. You'll see which ones and why.

Filtering executions

Use the filters at the top to find specific executions:

By agent - Show only executions of a particular agent. By status - Filter to completed, failed, or running executions. By date range - Show executions from the last day, week, month, or custom date range. By success/failure - Separate successful runs from failed ones.

You can combine filters to narrow down your search. For example, show only failed executions of the SEO audit agent from the last 7 days.

Viewing execution details

Click any execution to see its full details:

Overview section:
  • Complete input settings you used
  • When it started and finished
  • Final status and any error messages
  • Total credits consumed
Results section:
  • The agent's output or recommendations
  • Before/after comparisons (if applicable)
  • Data visualizations or reports
  • Files to download (CSVs, PDFs, etc.)
Processing log:
  • What the agent did step by step
  • How many items were processed
  • Which items had issues
  • Performance metrics
Actions:
  • Apply recommendations (if the agent provides them)
  • Download results
  • Run the agent again with the same settings
  • Share results with team members

Understanding results

Different agents present results in different formats:

Recommendation lists - Changes the agent suggests with before/after previews. You can approve or reject each one individually. Reports - Comprehensive analyses with charts, tables, and written summaries. Usually downloadable as PDF or CSV. Generated content - New text, images, or other assets ready to use. You can edit before applying. Scores and metrics - Numerical ratings or performance indicators with explanations of what they mean. Action items - Prioritized list of things to do based on the agent's analysis.

Most agents let you filter or sort results to focus on what matters most.

Applying recommendations

For agents that suggest changes:

  1. Open the execution details
  2. Review each recommendation
  3. Use filters to show only high-priority items
  4. Check the before/after preview
  5. Select which changes to apply
  6. Click Apply selected to push changes to your platform

You can apply recommendations immediately or come back later. The execution history stays available until you delete it.

Comparing executions

To see how agent results change over time:

  1. Find multiple executions of the same agent in your history
  2. Click Compare (if available for that agent type)
  3. View side-by-side results from different dates
  4. Identify trends and improvements

This is particularly useful for:

  • SEO agents (track ranking improvements)
  • Analytics agents (monitor metric changes)
  • Content agents (measure engagement over time)
  • Performance audits (see if fixes worked)

Downloading results

Most agent executions let you export results:

CSV format - For data like keyword lists, product scores, or performance metrics. Open in Excel or Google Sheets. PDF format - For comprehensive reports with charts and analysis. Good for sharing with stakeholders. JSON format - For developers who want to process results programmatically.

Look for the Download button on the execution details page. The available formats depend on the agent type.

Sharing executions

To share results with team members:

  1. Open the execution details
  2. Click Share at the top right
  3. Choose whether to share with specific team members or generate a link
  4. Set access permissions (view only or can apply recommendations)
  5. Add an optional message explaining what you want them to review

Team members can view shared executions even if they didn't run the agent themselves. This is useful for collaborative review and approval processes.

Re-running agents

If you want to run an agent again with the same settings:

  1. Open the execution details from your history
  2. Click Run again at the top
  3. Review the settings (you can adjust them if needed)
  4. Confirm the credit cost
  5. Click Run agent

This is faster than reconfiguring the agent from scratch, especially for complex setups.

Deleting executions

To remove old executions from your history:

  1. Find the execution you want to delete
  2. Click the three-dot menu on the right
  3. Select Delete
  4. Confirm the deletion
Warning: Deleted executions can't be recovered. Make sure you've downloaded any results you need before deleting.

Deleting an execution doesn't refund credits. It only removes it from your history view.

Using history to optimize credit usage

Your execution history helps you understand which agents provide the best return on your credit investment:

High-value agents - Executions that led to measurable improvements or that you frequently apply recommendations from. Low-value agents - Executions you rarely act on or that don't provide useful insights for your business. Cost trends - Track how credit usage changes as you adjust agent scope or settings. Frequency analysis - See which agents you run most often and whether you need more credits.

Review your history monthly to identify patterns and optimize your agent usage strategy.

Execution alerts and notifications

You can configure alerts for execution events:

Completion notifications - Get notified when long-running agents finish. Failure alerts - Receive immediate notification if an execution fails. Weekly summaries - Email digest of all executions from the past week. Credit thresholds - Alert when a single execution uses more than a specified number of credits.

Configure these in Settings → Notifications.

Troubleshooting failed executions

If an execution fails:

  1. Open the execution details
  2. Check the error message
  3. Look at the processing log to see where it failed
  4. Verify your platform connections are still active
  5. Check that you have necessary permissions
  6. Try reducing the scope (fewer items) and running again

Common failure reasons:

  • Platform connection lost
  • Insufficient data to analyze
  • Settings configured incorrectly
  • Platform rate limits exceeded
  • Network timeout

If you can't resolve the failure, contact support@convertmate.io with the execution ID.

History retention

Execution history is retained:

  • Completed executions - Kept for 12 months
  • Failed executions - Kept for 3 months
  • Downloaded reports - Available for 30 days after generation

After these periods, executions are archived. You can request archived data by contacting support@convertmate.io.

Privacy and team visibility

Default visibility:
  • You see all executions you ran
  • You see executions shared with you
  • You see executions from automated workflows you created
Admin visibility:
  • Workspace admins can see all executions from all team members
  • This helps with credit usage monitoring and audit trails
External sharing:
  • Execution results never visible to other ConvertMate customers
  • Share links can be password-protected for extra security

What's next

Questions about a specific execution? Use the chat widget in the bottom-right corner or email support@convertmate.io with the execution ID.

Was this article helpful?