Explore Mergent’s Task history feature, providing access to task data for 30 days post-completion
Task history is stored for 30 days after tasks are completed for paid plans, and
7 days after tasks are completed for free plans. After that, task history is
scheduled for permanent deletion from our servers.For example, if you schedule a task for 60 days from today, it will be deleted
in 67 days on the free plan (60 days until completed + 7 days until deleted),
and 90 days on the paid plan (60 days until completed + 30 days until deleted).Recurring schedules are never deleted automatically, just the tasks that they
spawn.You can view the Task history by clicking on the Task in the dashboard.
a screenshot of a Task that failed after many attempts of making a POST request to Google
Was this page helpful?
{"docsConfig":{"$schema":"https://mintlify.com/docs.json","theme":"mint","name":"Mergent","colors":{"primary":"#0091FF","light":"#0091FF","dark":"#0091FF"},"favicon":"/logo/dark.svg","logo":{"light":"https://mintlify.s3.us-west-1.amazonaws.com/mergent-64/logo/light.svg","dark":"https://mintlify.s3.us-west-1.amazonaws.com/mergent-64/logo/dark.svg","href":"https://mergent.co"},"api":{"openapi":"https://api.mergent.co/docs/v2/openapi.yaml"},"background":{"decoration":null,"color":{"light":"#FFF","dark":"#0C0D14"}},"navbar":{"links":[{"label":"Sign In","href":"https://app.mergent.co"}],"primary":{"type":"button","label":"Get Started","href":"https://app.mergent.co"}},"footer":{"socials":{"twitter":"https://twitter.com/mergentlabs","github":"https://github.com/mergentlabs"}},"integrations":{"ga4":{"measurementId":"G-E1GKRWEFXC"},"koala":{"publicApiKey":"pk_f134347ae179fc0ae5eef0f335a8a442ff17"},"intercom":{"appId":"t68rwlxl"}},"navigation":{"global":{"anchors":[{"anchor":"Dashboard","href":"https://app.mergent.co","icon":"table-columns"},{"anchor":"Changelog","href":"https://blog.mergent.co/tag/changelog","icon":"megaphone"},{"anchor":"API Status","href":"https://status.mergent.co","icon":"check"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"mergent-64","hasAudioNarration":false,"actualSubdomain":"mergent-64","customDomains":["docs.mergent.co"],"gitSource":{"type":"github","owner":"mergentlabs","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6a20c39c1b7c4331fd737aa3","collectionId":"2724be27-7a95-4862-aa05-cd342b91edb6","schemaVersion":"v2"},"feedback":{"thumbs":true},"entitlements":{},"buildId":"6a20c39c1b7c4331fd737aa3:success","clientVersion":"0.0.3964","searchFilterCounts":[{"language":"default","tag":"API Reference","count":28},{"language":"default","tag":"Documentation","count":23},{"language":"default","tag":"Concepts","count":9},{"language":"default","tag":"Quickstart","count":9},{"language":"default","tag":"Guides","count":3},{"language":"default","tag":"Getting Started","count":2},{"language":"default","tag":"JavaScript","count":2},{"language":"default","tag":"Go","count":2},{"language":"default","tag":"Java","count":1},{"language":"default","tag":"OCaml","count":1}]},"assistantConfig":{},"hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-v7-file-tree","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"pause-universal-search-reconcile","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"per-site-search-delta","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-private-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-nav-generations","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-agent-model-picker","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"isAtlas":false,"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"concepts/viewing-task-history","slug":"/concepts/viewing-task-history","pageMetadata":{"title":"Viewing Task History","description":"Explore Mergent's Task history feature, providing access to task data for 30 days post-completion","href":"/concepts/viewing-task-history"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Explore Mergent’s Task history feature, providing access to task data for 30 days post-completion\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={p:`p`,..._provideComponents(),...props.components},{Frame,OptimizedImage}=_components;if(!Frame)_missingMdxReference(`Frame`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Task history is stored for 30 days after tasks are completed for paid plans, and\n7 days after tasks are completed for free plans. After that, task history is\nscheduled for permanent deletion from our servers.`}),`\n`,_jsx(_components.p,{children:`For example, if you schedule a task for 60 days from today, it will be deleted\nin 67 days on the free plan (60 days until completed + 7 days until deleted),\nand 90 days on the paid plan (60 days until completed + 30 days until deleted).`}),`\n`,_jsx(_components.p,{children:`Recurring schedules are never deleted automatically, just the tasks that they\nspawn.`}),`\n`,_jsx(_components.p,{children:`You can view the Task history by clicking on the Task in the dashboard.`}),`\n`,_jsx(Frame,{caption:`a screenshot of a Task that failed after many attempts of making a POST request to Google`,children:_jsx(OptimizedImage,{src:`https://mintlify.s3.us-west-1.amazonaws.com/mergent-64/images/Screen%20Shot%202022-03-07%20at%204.03.29%20PM.png`})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Viewing Task History","description":"Explore Mergent's Task history feature, providing access to task data for 30 days post-completion","href":"/concepts/viewing-task-history"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"subdomain":"mergent-64","siteName":"Mergent","title":"Viewing Task History - Mergent","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"originalFileLocation":"concepts/viewing-task-history.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Explore Mergent\u0026#x27;s Task history feature, providing access to task data for 30 days post-completion\">\u003cmeta data-mint-head name=\"application-name\" content=\"Mergent\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/mergent-64/_generated/favicon/apple-touch-icon.png?v=3\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/mergent-64/_generated/favicon/favicon-32x32.png?v=3\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/mergent-64/_generated/favicon/favicon-16x16.png?v=3\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/mergent-64/_generated/favicon/favicon.ico?v=3\">\u003cmeta data-mint-head property=\"og:title\" content=\"Viewing Task History - Mergent\">\u003cmeta data-mint-head property=\"og:description\" content=\"Explore Mergent\u0026#x27;s Task history feature, providing access to task data for 30 days post-completion\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Mergent\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.mergent.co/concepts/viewing-task-history\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://mergent-64.mintlify.app/_mintlify/api/og/v2?division=Concepts\u0026amp;title=Viewing+Task+History\u0026amp;description=Explore+Mergent%27s+Task+history+feature%2C+providing+access+to+task+data+for+30+days+post-completion\u0026amp;theme=0cf63544d88ecfa22aed1e2f\u0026amp;signature=79a512409f51e59bd597b370d892ba87784201f7df64a14d47b71ee5f151f4f2\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Viewing Task History - Mergent\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Explore Mergent\u0026#x27;s Task history feature, providing access to task data for 30 days post-completion\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://mergent-64.mintlify.app/_mintlify/api/og/v2?division=Concepts\u0026amp;title=Viewing+Task+History\u0026amp;description=Explore+Mergent%27s+Task+history+feature%2C+providing+access+to+task+data+for+30+days+post-completion\u0026amp;theme=0cf63544d88ecfa22aed1e2f\u0026amp;signature=79a512409f51e59bd597b370d892ba87784201f7df64a14d47b71ee5f151f4f2\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"https://mintlify.s3.us-west-1.amazonaws.com/mergent-64/_generated/favicon/browserconfig.xml?v=3\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Mergent\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0091FF\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.mergent.co/concepts/viewing-task-history\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/concepts/viewing-task-history.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.mergent.co/#organization\",\"name\":\"Mergent\",\"url\":\"https://docs.mergent.co\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintlify.s3.us-west-1.amazonaws.com/mergent-64/logo/light.svg\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.mergent.co#website\",\"name\":\"Mergent\",\"url\":\"https://docs.mergent.co\",\"publisher\":{\"@id\":\"https://docs.mergent.co/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.mergent.co/concepts/viewing-task-history#webpage\",\"url\":\"https://docs.mergent.co/concepts/viewing-task-history\",\"name\":\"Viewing Task History\",\"description\":\"Explore Mergent's Task history feature, providing access to task data for 30 days post-completion\",\"isPartOf\":{\"@id\":\"https://docs.mergent.co#website\"},\"breadcrumb\":{\"@id\":\"https://docs.mergent.co/concepts/viewing-task-history#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.mergent.co/concepts/viewing-task-history#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Concepts\",\"item\":\"https://docs.mergent.co/concepts/tasks-and-schedules\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Viewing Task History\",\"item\":\"https://docs.mergent.co/concepts/viewing-task-history\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.mergent.co/concepts/viewing-task-history#article\",\"headline\":\"Viewing Task History\",\"name\":\"Viewing Task History\",\"description\":\"Explore Mergent's Task history feature, providing access to task data for 30 days post-completion\",\"url\":\"https://docs.mergent.co/concepts/viewing-task-history\",\"mainEntityOfPage\":{\"@id\":\"https://docs.mergent.co/concepts/viewing-task-history#webpage\"},\"publisher\":{\"@id\":\"https://docs.mergent.co/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.mergent.co#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Mergent\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Mergent","nav":{"global":{"anchors":[{"anchor":"Dashboard","href":"https://app.mergent.co","icon":"table-columns"},{"anchor":"Changelog","href":"https://blog.mergent.co/tag/changelog","icon":"megaphone"},{"anchor":"API Status","href":"https://status.mergent.co","icon":"check"}]},"tabs":[{"tab":"Documentation","groups":[{"group":"Getting Started","pages":[{"title":"Introduction","href":"/introduction"},{"title":"Pricing","href":"/pricing"}]},{"group":"Quickstart","pages":[{"group":"JavaScript","pages":[{"title":"Next.js","href":"/quickstart/nextjs"},{"title":"Express","href":"/quickstart/express"}]},{"group":"PHP","pages":[{"title":"Laravel","href":"/quickstart/php-laravel"}]},{"group":"Python","pages":[{"title":"Flask","href":"/quickstart/python-flask"}]},{"group":"Ruby","pages":[{"title":"Sinatra","href":"/quickstart/sinatra"}]},{"group":"Go","pages":[{"title":"Chi","href":"/quickstart/go-chi"},{"title":"Gin","href":"/quickstart/go-gin"}]},{"group":"Java","pages":[{"title":"Spring Boot","href":"/quickstart/java-spring-boot"}]},{"group":"OCaml","pages":[{"title":"Cohttp + Lwt","href":"/quickstart/ocaml-cohttp-lwt"}]}]},{"group":"Concepts","pages":[{"title":"Introduction to Tasks \u0026 Schedules","href":"/concepts/tasks-and-schedules"},{"title":"How Tasks Work","href":"/concepts/how-tasks-work"},{"title":"How Schedules Work","href":"/concepts/how-schedules-work"},{"title":"Request Failures \u0026 Retries","href":"/concepts/request-failures-and-retries"},{"title":"Request Timeouts","href":"/concepts/request-timeouts"},{"title":"Task Rate Limits (Beta)","description":"Learn how to limit the rate at which tasks are dispatched to your application.","href":"/concepts/task-rate-limits"},{"title":"Viewing Task History","href":"/concepts/viewing-task-history"},{"title":"Webhooks Security","description":"Learn to implement security for your incoming webhooks with HTTP authentication and origin signature validation","href":"/concepts/webhooks-security"},{"title":"Quotas \u0026 Limits","href":"/concepts/quotas"}]},{"group":"Guides","pages":[{"title":"Localhost Dev \u0026 Webhooks","href":"/guides/localhost-dev-and-webhooks"},{"title":"Understanding Cron Syntax","href":"/guides/understanding-cron-syntax"},{"title":"Understanding RRule Syntax","href":"/guides/understanding-rrule-syntax"}]}]},{"tab":"API Reference","pages":[{"title":"API Reference","href":"/api-reference/overview"}]}]},"title":"Viewing Task History - Mergent","buildId":"dpl_HcHmUS6i3UwswnTHJUEdcTtwfdTQ","deploymentId":"dpl_HcHmUS6i3UwswnTHJUEdcTtwfdTQ","dynamics":["07c022d89b","a74be98ba7"],"chunks":["Frame-D1UCVuPB.js","DynamicMarkdown-Crwq6WG_.js","zoom-image-lightbox-CFBqa0On.js","lightbox-handle-r17bVUz3.js"]}