The exact prompt the task should run. This must be self-contained and executable without asking the user follow-up questions. Include any reasonable assumptions needed to complete the task, and do not include instructions like 'ask the user' or 'wait for clarification'.
Where each run's results go, e.g. { email: { recipients: ["me@brand.com"] } }. When the user wants results delivered, default to their own address. { email: { recipients: [] } } turns email off; omitting it on update keeps the current delivery.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Replo","colors":{"primary":"#274AE2","light":"#F5FAD9","dark":"#274AE2"},"logo":{"light":"https://mintcdn.com/replo-agent-docs/NFnfdLlAm3qJcc0U/logo/light.svg?fit=max\u0026auto=format\u0026n=NFnfdLlAm3qJcc0U\u0026q=85\u0026s=67cd8b3a8123594574eb6f94e14a385d","dark":"https://mintcdn.com/replo-agent-docs/NFnfdLlAm3qJcc0U/logo/dark.svg?fit=max\u0026auto=format\u0026n=NFnfdLlAm3qJcc0U\u0026q=85\u0026s=ced14503b0f83c66b4a96066ccf9edaa"},"favicon":"https://mintcdn.com/replo-agent-docs/OPJtEy-zSFLCF1g2/favicon.svg?fit=max\u0026auto=format\u0026n=OPJtEy-zSFLCF1g2\u0026q=85\u0026s=66a4e65ee84abd32d5b1e5150d1516b3","navbar":{"links":[{"href":"mailto:support@replo.app","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://dashboard.replo.app"}},"footer":{"socials":{"x":"https://x.com/replohq","linkedin":"https://linkedin.com/company/replohq"}},"integrations":{"gtm":{"tagId":"GTM-MH56PQ8"}},"contextual":{"options":[],"display":"header"},"thumbnails":{"appearance":"dark","background":"https://mintcdn.com/replo-agent-docs/3vMlpzakdB9-cblW/images/thumbnail.png?fit=max\u0026auto=format\u0026n=3vMlpzakdB9-cblW\u0026q=85\u0026s=18cbcc75b6e45002ac50e37bb5f686c9"},"styling":{"latex":true},"navigation":{"global":{"anchors":[{"anchor":"Announcements","icon":"megaphone","href":"https://www.replo.app/changelog"},{"anchor":"Request a Feature","icon":"rocket","href":"https://feedback.replo.app/"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"replo-agent-docs","hasAudioNarration":false,"actualSubdomain":"replo-agent-docs","customDomains":["docs.replo.app"],"gitSource":{"type":"github","owner":"replohq","repo":"andytown","deployBranch":"main","contentDirectory":"apps/docs","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6aeec4723729d361787d7917","clientVersion":"0.0.4076","searchFilterCounts":[{"language":"default","tag":"Integrations","count":138},{"language":"default","tag":"Getting started","count":88},{"language":"default","tag":"FAQ","count":66},{"language":"default","tag":"API Reference","count":64},{"language":"default","tag":"Endpoints","count":55},{"language":"default","tag":"Features","count":36},{"language":"default","tag":"Commerce","count":29},{"language":"default","tag":"Other Checkout \u0026 Bookings","count":21},{"language":"default","tag":"Site Features","count":14},{"language":"default","tag":"Developers","count":13}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","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":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","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":"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":"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":"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":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","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":"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":"workos-sso-scim","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},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"comment-mode","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"styles.css","content":".katex-html{overflow:hidden}pre[language=\"text\"],pre[language=\"text\"] code{white-space:pre-wrap!important;overflow-wrap:break-word!important}pre[language=\"text\"] code{width:auto!important;max-width:100%!important}#table-of-contents{-ms-overflow-style:none;scrollbar-width:none}#table-of-contents::-webkit-scrollbar{display:none}/*! Devices.css v0.2.0 | MIT License | github.com/picturepan2/devices.css */.device,.device *,.device ::after,.device ::before,.device::after,.device::before{box-sizing:border-box;display:block}.device{position:relative;transform:scale(1);z-index:1}.device .device-frame{z-index:1}.device .device-screen{background-color:#000;background-position:center center;background-size:cover;object-fit:cover;position:relative}.device-iphone-14-pro{height:868px;width:428px}.device-iphone-14-pro .device-frame{background:#010101;border:1px solid #1b1721;border-radius:68px;box-shadow:inset 0 0 4px 2px #c0b7cd,inset 0 0 0 6px #342c3f;height:868px;padding:19px;width:428px}.device-iphone-14-pro .device-screen{border-radius:49px;height:830px;width:390px}.device-iphone-14-pro .device-stripe::after,.device-iphone-14-pro .device-stripe::before{border:solid rgba(1,1,1,.25);border-width:0 7px;content:\"\";height:7px;left:0;position:absolute;width:100%;z-index:9}.device-iphone-14-pro .device-stripe::after{top:85px}.device-iphone-14-pro .device-stripe::before{bottom:85px}.device-iphone-14-pro .device-header{background:#010101;border-radius:20px;height:35px;left:50%;margin-left:-60px;position:absolute;top:29px;width:120px}.device-iphone-14-pro .device-sensors::after,.device-iphone-14-pro .device-sensors::before{content:\"\";position:absolute}.device-iphone-14-pro .device-sensors::after{background:#010101;border-radius:17px;height:33px;left:50%;margin-left:-60px;top:30px;width:74px}.device-iphone-14-pro .device-sensors::before{background:radial-gradient(farthest-corner at 20% 20%,#6074bf 0,transparent 40%),radial-gradient(farthest-corner at 80% 80%,#513785 0,#24555e 20%,transparent 50%);border-radius:50%;box-shadow:0 0 1px 1px rgba(255,255,255,.05);height:9px;left:50%;margin-left:36px;top:42px;width:9px}.device-iphone-14-pro .device-btns{background:#1b1721;border-radius:2px;height:32px;left:-2px;position:absolute;top:115px;width:3px}.device-iphone-14-pro .device-btns::after,.device-iphone-14-pro .device-btns::before{background:#1b1721;border-radius:2px;content:\"\";height:62px;left:0;position:absolute;width:3px}.device-iphone-14-pro .device-btns::after{top:60px}.device-iphone-14-pro .device-btns::before{top:140px}.device-iphone-14-pro .device-power{background:#1b1721;border-radius:2px;height:100px;position:absolute;right:-2px;top:200px;width:3px}.device-iphone-14-pro .device-home::after,.device-iphone-14-pro .device-home::before{border:solid rgba(1,1,1,.25);border-width:6px 0;content:\"\";height:6px;position:absolute;width:6px;z-index:9}.device-iphone-14-pro .device-home::after{right:86px;top:0}.device-iphone-14-pro .device-home::before{bottom:0;left:86px}.device-iphone-14-pro.device-silver .device-frame{border-color:#c8cacb;box-shadow:inset 0 0 4px 2px #fff,inset 0 0 0 6px #e2e3e4}.device-iphone-14-pro.device-silver .device-btns{background:#c8cacb}.device-iphone-14-pro.device-silver .device-btns::after,.device-iphone-14-pro.device-silver .device-btns::before{background:#c8cacb}.device-iphone-14-pro.device-silver .device-power{background:#c8cacb}.device-iphone-14-pro.device-black .device-frame{border-color:#5c5956;box-shadow:inset 0 0 4px 2px #fff,inset 0 0 0 6px #76726f}.device-iphone-14-pro.device-black .device-btns{background:#5c5956}.device-iphone-14-pro.device-black .device-btns::after,.device-iphone-14-pro.device-black .device-btns::before{background:#5c5956}.device-iphone-14-pro.device-black .device-power{background:#5c5956}.device-iphone-14-pro.device-gold .device-frame{border-color:#e7d19e;box-shadow:inset 0 0 4px 2px #fff,inset 0 0 0 6px #d2ab4c}.device-iphone-14-pro.device-gold .device-btns{background:#e7d19e}.device-iphone-14-pro.device-gold .device-btns::after,.device-iphone-14-pro.device-gold .device-btns::before{background:#e7d19e}.device-iphone-14-pro.device-gold .device-power{background:#e7d19e}.device-iphone-14{height:868px;width:428px}.device-iphone-14 .device-frame{background:#010101;border:1px solid #101315;border-radius:68px;box-shadow:inset 0 0 4px 2px #b0b8c0,inset 0 0 0 6px #272c31;height:868px;padding:19px;width:428px}.device-iphone-14 .device-screen{border-radius:49px;height:830px;width:390px}.device-iphone-14 .device-stripe::after,.device-iphone-14 .device-stripe::before{border:solid rgba(1,1,1,.25);border-width:0 7px;content:\"\";height:7px;left:0;position:absolute;width:100%;z-index:9}.device-iphone-14 .device-stripe::after{top:85px}.device-iphone-14 .device-stripe::before{bottom:85px}.device-iphone-14 .device-header{background:#010101;border-bottom-left-radius:20px;border-bottom-right-radius:20px;height:30px;left:50%;margin-left:-80px;position:absolute;top:20px;width:160px}.device-iphone-14 .device-header::after,.device-iphone-14 .device-header::before{content:\"\";height:10px;position:absolute;top:0;width:10px}.device-iphone-14 .device-header::after{background:radial-gradient(circle at bottom left,transparent 0,transparent 75%,#010101 75%,#010101 100%);left:-10px}.device-iphone-14 .device-header::before{background:radial-gradient(circle at bottom right,transparent 0,transparent 75%,#010101 75%,#010101 100%);right:-10px}.device-iphone-14 .device-sensors::after,.device-iphone-14 .device-sensors::before{content:\"\";position:absolute}.device-iphone-14 .device-sensors::after{background:#151515;border:1px solid #010101;border-radius:4px;box-shadow:0 0 4px #151515;height:7px;left:50%;margin-left:-35px;top:8px;width:70px}.device-iphone-14 .device-sensors::before{background:radial-gradient(farthest-corner at 20% 20%,#6074bf 0,transparent 40%),radial-gradient(farthest-corner at 80% 80%,#513785 0,#24555e 20%,transparent 50%);border-radius:50%;box-shadow:0 0 1px 1px rgba(255,255,255,.05);height:9px;left:50%;margin-left:-60px;top:26px;width:9px}.device-iphone-14 .device-btns{background:#101315;border-radius:2px;height:32px;left:-2px;position:absolute;top:115px;width:3px}.device-iphone-14 .device-btns::after,.device-iphone-14 .device-btns::before{background:#101315;border-radius:2px;content:\"\";height:62px;left:0;position:absolute;width:3px}.device-iphone-14 .device-btns::after{top:60px}.device-iphone-14 .device-btns::before{top:140px}.device-iphone-14 .device-power{background:#101315;border-radius:2px;height:100px;position:absolute;right:-2px;top:200px;width:3px}.device-iphone-14 .device-home::after,.device-iphone-14 .device-home::before{border:solid rgba(1,1,1,.25);border-width:6px 0;content:\"\";height:6px;position:absolute;width:6px;z-index:9}.device-iphone-14 .device-home::after{right:86px;top:0}.device-iphone-14 .device-home::before{bottom:0;left:86px}.device-iphone-14.device-purple .device-frame{border-color:#af9bbf;box-shadow:inset 0 0 4px 2px #fff,inset 0 0 0 6px #c8bad3}.device-iphone-14.device-purple .device-btns{background:#af9bbf}.device-iphone-14.device-purple .device-btns::after,.device-iphone-14.device-purple .device-btns::before{background:#af9bbf}.device-iphone-14.device-purple .device-power{background:#af9bbf}.device-iphone-14.device-starlight .device-frame{border-color:#bdb4aa;box-shadow:inset 0 0 4px 2px #fff,inset 0 0 0 6px #d3cdc7}.device-iphone-14.device-starlight .device-btns{background:#bdb4aa}.device-iphone-14.device-starlight .device-btns::after,.device-iphone-14.device-starlight .device-btns::before{background:#bdb4aa}.device-iphone-14.device-starlight .device-power{background:#bdb4aa}.device-iphone-14.device-red .device-frame{border-color:#d11813;box-shadow:inset 0 0 4px 2px #fff,inset 0 0 0 6px #ec302b}.device-iphone-14.device-red .device-btns{background:#d11813}.device-iphone-14.device-red .device-btns::after,.device-iphone-14.device-red .device-btns::before{background:#d11813}.device-iphone-14.device-red .device-power{background:#d11813}.device-iphone-14.device-blue .device-frame{border-color:#7992aa;box-shadow:inset 0 0 4px 2px #fff,inset 0 0 0 6px #98abbe}.device-iphone-14.device-blue .device-btns{background:#7992aa}.device-iphone-14.device-blue .device-btns::after,.device-iphone-14.device-blue .device-btns::before{background:#7992aa}.device-iphone-14.device-blue .device-power{background:#7992aa}.device-iphone-x{height:868px;width:428px}.device-iphone-x .device-frame{background:#222;border-radius:68px;box-shadow:inset 0 0 2px 2px #c8cacb,inset 0 0 0 7px #e2e3e4;height:868px;padding:28px;width:428px}.device-iphone-x .device-screen{border-radius:40px;height:812px;width:375px}.device-iphone-x .device-stripe::after,.device-iphone-x .device-stripe::before{border:solid rgba(1,1,1,.25);border-width:0 7px;content:\"\";height:7px;left:0;position:absolute;width:100%;z-index:9}.device-iphone-x .device-stripe::after{top:85px}.device-iphone-x .device-stripe::before{bottom:85px}.device-iphone-x .device-header{background:#222;border-bottom-left-radius:20px;border-bottom-right-radius:20px;height:30px;left:50%;margin-left:-102px;position:absolute;top:28px;width:204px}.device-iphone-x .device-header::after,.device-iphone-x .device-header::before{content:\"\";height:10px;position:absolute;top:0;width:10px}.device-iphone-x .device-header::after{background:radial-gradient(circle at bottom left,transparent 0,transparent 75%,#222 75%,#222 100%);left:-10px}.device-iphone-x .device-header::before{background:radial-gradient(circle at bottom right,transparent 0,transparent 75%,#222 75%,#222 100%);right:-10px}.device-iphone-x .device-sensors::after,.device-iphone-x .device-sensors::before{content:\"\";position:absolute}.device-iphone-x .device-sensors::after{background:#333;border-radius:3px;height:6px;left:50%;margin-left:-25px;top:32px;width:50px}.device-iphone-x .device-sensors::before{background:radial-gradient(farthest-corner at 20% 20%,#6074bf 0,transparent 40%),radial-gradient(farthest-corner at 80% 80%,#513785 0,#24555e 20%,transparent 50%);border-radius:50%;box-shadow:0 0 1px 1px rgba(255,255,255,.05);height:10px;left:50%;margin-left:42px;top:30px;width:10px}.device-iphone-x .device-btns{background:#c8cacb;height:32px;left:-3px;position:absolute;top:115px;width:3px}.device-iphone-x .device-btns::after,.device-iphone-x .device-btns::before{background:#c8cacb;content:\"\";height:62px;left:0;position:absolute;width:3px}.device-iphone-x .device-btns::after{top:60px}.device-iphone-x .device-btns::before{top:140px}.device-iphone-x .device-power{background:#c8cacb;height:100px;position:absolute;right:-3px;top:200px;width:3px}.device-iphone-8{height:871px;width:419px}.device-iphone-8 .device-frame{background:#fff;border-radius:68px;box-shadow:inset 0 0 0 2px #c8cacb,inset 0 0 0 7px #e2e3e4;height:871px;padding:102px 22px;width:419px}.device-iphone-8 .device-screen{border:2px solid #222;border-radius:4px;height:667px;width:375px}.device-iphone-8 .device-stripe::after,.device-iphone-8 .device-stripe::before{border:solid rgba(51,51,51,.15);border-width:0 7px;content:\"\";height:6px;left:0;position:absolute;width:100%;z-index:9}.device-iphone-8 .device-stripe::after{top:68px}.device-iphone-8 .device-stripe::before{bottom:68px}.device-iphone-8 .device-home{border:2px solid #c8cacb;border-radius:50%;bottom:25px;height:58px;left:50%;margin-left:-29px;position:absolute;width:58px}.device-iphone-8 .device-sensors{background:#666;border-radius:3px;height:6px;left:50%;margin-left:-38px;position:absolute;top:52px;width:76px}.device-iphone-8 .device-sensors::after,.device-iphone-8 .device-sensors::before{background:#666;border-radius:50%;content:\"\";position:absolute}.device-iphone-8 .device-sensors::after{height:10px;left:50%;margin-left:-5px;top:-25px;width:10px}.device-iphone-8 .device-sensors::before{height:12px;left:-42px;margin-top:-6px;top:50%;width:12px}.device-iphone-8 .device-btns{background:#c8cacb;height:30px;left:-3px;position:absolute;top:102px;width:3px}.device-iphone-8 .device-btns::after,.device-iphone-8 .device-btns::before{background:#c8cacb;content:\"\";height:56px;left:0;position:absolute;width:3px}.device-iphone-8 .device-btns::after{top:62px}.device-iphone-8 .device-btns::before{top:132px}.device-iphone-8 .device-power{background:#c8cacb;height:80px;position:absolute;right:-2px;top:160px;width:3px}.device-iphone-8.device-gold .device-frame{box-shadow:inset 0 0 0 2px #e4b08a,inset 0 0 0 7px #f7e8dd}.device-iphone-8.device-gold .device-home{border-color:#e4b08a}.device-iphone-8.device-gold .device-btns,.device-iphone-8.device-gold .device-btns::after,.device-iphone-8.device-gold .device-btns::before{background:#e4b08a}.device-iphone-8.device-gold .device-power{background:#e4b08a}.device-iphone-8.device-spacegray .device-frame{background:#222;box-shadow:inset 0 0 0 2px #74747a,inset 0 0 0 7px #9b9ba0}.device-iphone-8.device-spacegray .device-stripe::after,.device-iphone-8.device-spacegray .device-stripe::before{border-color:rgba(204,204,204,.35)}.device-iphone-8.device-spacegray .device-btns,.device-iphone-8.device-spacegray .device-btns::after,.device-iphone-8.device-spacegray .device-btns::before{background:#74747a}.device-macbook-pro{height:434px;width:740px}.device-macbook-pro .device-frame{background:#0d0d0d;border-radius:20px;box-shadow:inset 0 0 0 2px #c8cacb;height:418px;margin:0 auto;padding:9px 9px 23px 9px;position:relative;width:618px}.device-macbook-pro .device-frame::after{background:linear-gradient(to bottom,#272727,#0d0d0d);border-radius:0 0 20px 20px;bottom:2px;content:\"\";height:24px;left:2px;position:absolute;width:614px}.device-macbook-pro .device-header{background:#0d0d0d;border-bottom-left-radius:4px;border-bottom-right-radius:4px;height:12px;left:50%;margin-left:-32px;position:absolute;top:11px;width:64px;z-index:2}.device-macbook-pro .device-header::after,.device-macbook-pro .device-header::before{content:\"\";height:4px;position:absolute;top:0;width:4px}.device-macbook-pro .device-header::after{background:radial-gradient(circle at bottom left,transparent 0,transparent 75%,#0d0d0d 75%,#0d0d0d 100%);left:-4px}.device-macbook-pro .device-header::before{background:radial-gradient(circle at bottom right,transparent 0,transparent 75%,#0d0d0d 75%,#0d0d0d 100%);right:-4px}.device-macbook-pro .device-screen{border:2px solid #121212;border-radius:10px 10px 0 0;height:375px;width:600px}.device-macbook-pro .device-power{background:radial-gradient(circle at center,#e2e3e4 85%,#c8cacb 100%);border:solid #a0a3a7;border-radius:2px 2px 12px 12px;border-width:1px 2px 0 2px;box-shadow:inset 0 -2px 8px 0 #6c7074;height:24px;margin-top:-10px;position:relative;width:740px;z-index:9}.device-macbook-pro .device-power::after{background:#e2e3e4;border-radius:0 0 10px 10px;box-shadow:inset 0 0 4px 2px #babdbf;content:\"\";height:10px;left:50%;margin-left:-60px;position:absolute;top:0;width:120px}.device-macbook-pro .device-power::before{background:0 0;border-radius:0 0 3px 3px;bottom:-2px;box-shadow:-300px 0 #272727,300px 0 #272727;content:\"\";height:2px;left:50%;margin-left:-20px;position:absolute;width:40px}.device-macbook-pro.device-spacegray .device-frame{box-shadow:inset 0 0 0 2px #767a7d}.device-macbook-pro.device-spacegray .device-power{background:radial-gradient(circle at center,#83878a 85%,#767a7d 100%);border-color:#454749;box-shadow:inset 0 -2px 8px 0 #202121}.device-macbook-pro.device-spacegray .device-power::after{background:#b7babc;box-shadow:inset 0 0 4px 2px #6a6d70}"}],"page":{"pagePath":"api-reference/tasks/create-a-task","slug":"/api-reference/tasks/create-a-task","pageMetadata":{"title":"Create a task","description":null,"deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /tasks","href":"/api-reference/tasks/create-a-task","autogeneratedByOpenApi":true},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Create a task","description":null,"deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /tasks","href":"/api-reference/tasks/create-a-task","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"tasks.create","summary":"Create a task","tags":["Tasks"],"parameters":["0fd335f3-0385-49e3-97c6-3aa6a67d0939"],"security":["dd25cadb-7314-4be4-acba-84ea66af0a9c"],"requestBody":"8472d446-cd87-429e-9574-c544bda2530b","responses":{"201":"e46a065b-48cc-47a3-bce1-8792f073c804","400":"3627b39b-8665-490e-9276-bc1b8587f6e1","401":"c7702577-d5ff-4f85-af4b-f2ad8e137b21","403":"6d8e997d-fb9a-4c86-a911-6108ce8efdc2","404":"d5ef4843-be8a-49c0-9e87-578153677727","409":"c219c058-9634-4bdd-8121-f0dce14a71fb","413":"308cbe10-a32d-4436-aa12-a72c56309cc4","429":"1f23342a-79ae-4271-b048-78fe40ddcb6a","500":"3ae779c7-5c7b-4556-a24e-bbbe1c3dbcf6","503":"5506ab58-4796-4832-92c5-63f535da9917"},"method":"post","type":"path","servers":["64e807d5-00d8-4c1e-bcbc-ab2b938bd979"],"path":"/tasks","baseUrlOptions":["https://api.replo.app/v1"],"title":"Create a task","description":"","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"0fd335f3-0385-49e3-97c6-3aa6a67d0939":{"name":"Replo-Api-Version","in":"header","required":true,"schema":{"type":"string","enum":["2026-10-29"],"isRequired":true,"description":"The public API version to use for this request.","uniqueKey":"","typeLabel":"enum\u003cstring>"},"description":"The public API version to use for this request."}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"title":{"type":"string","minLength":1,"maxLength":255,"description":"Short human-readable title for the task.","isRequired":true,"uniqueKey":"title","typeLabel":"string"},"prompt":{"type":"string","minLength":1,"description":"The exact prompt the task should run. This must be self-contained and executable without asking the user follow-up questions. Include any reasonable assumptions needed to complete the task, and do not include instructions like 'ask the user' or 'wait for clarification'.","isRequired":true,"uniqueKey":"prompt","typeLabel":"string"},"scheduledAt":{"type":"string","format":"date-time","description":"ISO 8601 date-time with an explicit timezone offset when the task should first run. Must be in the future.","isRequired":true,"uniqueKey":"scheduledAt","typeLabel":"string\u003cdate-time>"},"projectId":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"projectId","typeLabel":"string\u003cuuid>"},"emoji":{"type":"string","minLength":1,"maxLength":8,"default":"✨","description":"Emoji label used to visually group this task in the schedule UI.","uniqueKey":"emoji","typeLabel":"string"},"rrule":{"type":"string","minLength":1,"default":"FREQ=DAILY;COUNT=1","description":"RRULE string for recurrence, such as FREQ=DAILY. Use FREQ=DAILY;COUNT=1 for one-time tasks.","uniqueKey":"rrule","typeLabel":"string"},"delivery":{"type":"object","properties":{"email":{"type":"object","properties":{"recipients":{"type":"array","items":{"type":"string","format":"email","uniqueKey":"delivery.email.recipients.items.[INDEX]","typeLabel":"string\u003cemail>"},"maxItems":10,"description":"TaskEmailRecipients","isRequired":true,"uniqueKey":"delivery.email.recipients","typeLabel":"string\u003cemail>[]"}},"required":["recipients"],"uniqueKey":"delivery.email","typeLabel":"object"}},"description":"Where each run's results go, e.g. { email: { recipients: [\"me@brand.com\"] } }. When the user wants results delivered, default to their own address. `{ email: { recipients: [] } }` turns email off; omitting it on update keeps the current delivery.","uniqueKey":"delivery","typeLabel":"object"},"recipeId":{"type":"string","minLength":1,"maxLength":80,"description":"Id of the task recipe this task is based on, when the user picked one; its sample email becomes the run's layout guideline.","uniqueKey":"recipeId","typeLabel":"string"}},"required":["title","prompt","scheduledAt","projectId"],"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"title":"\u003cstring>","prompt":"\u003cstring>","scheduledAt":"2023-11-07T05:31:56Z","projectId":"3c90c3cc-0d44-4b50-8888-8dd25736052a","emoji":"✨","rrule":"FREQ=DAILY;COUNT=1","delivery":{},"recipeId":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"e46a065b-48cc-47a3-bce1-8792f073c804":{"description":"Create a task","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["task"],"isRequired":true,"uniqueKey":"object","typeLabel":"enum\u003cstring>"},"id":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"id","typeLabel":"string\u003cuuid>"},"title":{"type":"string","isRequired":true,"uniqueKey":"title","typeLabel":"string"},"emoji":{"type":"string","isRequired":true,"uniqueKey":"emoji","typeLabel":"string"},"rrule":{"type":"string","isRequired":true,"uniqueKey":"rrule","typeLabel":"string"},"nextRunAt":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"nextRunAt.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"nextRunAt.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"nextRunAt","typeLabel":"string | null"},"pausedAt":{"oneOf":[{"type":"string","description":"When the task was paused; paused tasks don't run.","isRequired":true,"uniqueKey":"pausedAt.oneOf.0","typeLabel":"string"},{"type":"null","description":"When the task was paused; paused tasks don't run.","isRequired":true,"uniqueKey":"pausedAt.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"pausedAt","typeLabel":"string | null"},"delivery":{"oneOf":[{"type":"object","properties":{"email":{"type":"object","properties":{"recipients":{"type":"array","items":{"type":"string","format":"email","uniqueKey":"delivery.oneOf.0.email.recipients.items.[INDEX]","typeLabel":"string\u003cemail>"},"maxItems":10,"description":"TaskEmailRecipients","isRequired":true,"uniqueKey":"delivery.oneOf.0.email.recipients","typeLabel":"string\u003cemail>[]"}},"required":["recipients"],"uniqueKey":"delivery.oneOf.0.email","typeLabel":"object"}},"description":"Where each run's results go.","isRequired":true,"uniqueKey":"delivery.oneOf.0","typeLabel":"object"},{"type":"null","properties":{"email":{"type":"object","properties":{"recipients":{"type":"array","items":{"type":"string","format":"email"},"maxItems":10,"description":"TaskEmailRecipients"}},"required":["recipients"]}},"description":"Where each run's results go.","isRequired":true,"uniqueKey":"delivery.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"delivery","typeLabel":"object | null"},"createdAt":{"type":"string","isRequired":true,"uniqueKey":"createdAt","typeLabel":"string"},"updatedAt":{"type":"string","isRequired":true,"uniqueKey":"updatedAt","typeLabel":"string"}},"required":["object","id","title","emoji","rrule","nextRunAt","pausedAt","delivery","createdAt","updatedAt"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"object":"task","id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","title":"\u003cstring>","emoji":"\u003cstring>","rrule":"\u003cstring>","nextRunAt":"\u003cstring>","pausedAt":"\u003cstring>","delivery":{"email":{"recipients":["jsmith@example.com"]}},"createdAt":"\u003cstring>","updatedAt":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"3627b39b-8665-490e-9276-bc1b8587f6e1":{"description":"Invalid request.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"doc_url":{"type":"string","isRequired":true,"uniqueKey":"error.doc_url","typeLabel":"string"},"issues":{"type":"array","items":{"type":"object","properties":{"param":{"oneOf":[{"type":"string","description":"Dotted path to the failing field within the request body, query or path, e.g. \"name\" or \"variants.0.available\"; null when the rule covers the whole input.","isRequired":true,"uniqueKey":"error.issues.items.[INDEX].param.oneOf.0","typeLabel":"string"},{"type":"null","description":"Dotted path to the failing field within the request body, query or path, e.g. \"name\" or \"variants.0.available\"; null when the rule covers the whole input.","isRequired":true,"uniqueKey":"error.issues.items.[INDEX].param.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"error.issues.items.[INDEX].param","typeLabel":"string | null"},"message":{"type":"string","description":"Why the field was rejected.","isRequired":true,"uniqueKey":"error.issues.items.[INDEX].message","typeLabel":"string"}},"required":["param","message"],"uniqueKey":"error.issues.items.[INDEX]","typeLabel":"object"},"description":"Present on an invalid_request whose input failed validation: each failing field and why, at most 10.","uniqueKey":"error.issues","typeLabel":"object[]"}},"required":["code","message","doc_url"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>","doc_url":"\u003cstring>","issues":[{"param":"\u003cstring>","message":"\u003cstring>"}]}}}},"exampleType":"generated"}},"exampleType":"generated"},"c7702577-d5ff-4f85-af4b-f2ad8e137b21":{"description":"Missing or invalid Replo Public API token. Send an active key as `Authorization: Bearer replo_sk_...`; if it was revoked, create a new key in Replo Settings.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"doc_url":{"type":"string","isRequired":true,"uniqueKey":"error.doc_url","typeLabel":"string"},"issues":{"type":"array","items":{"type":"object","properties":{"param":{"oneOf":[{"type":"string","description":"Dotted path to the failing field within the request body, query or path, e.g. \"name\" or \"variants.0.available\"; null when the rule covers the whole input.","isRequired":true,"uniqueKey":"error.issues.items.[INDEX].param.oneOf.0","typeLabel":"string"},{"type":"null","description":"Dotted path to the failing field within the request body, query or path, e.g. \"name\" or \"variants.0.available\"; null when the rule covers the whole input.","isRequired":true,"uniqueKey":"error.issues.items.[INDEX].param.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"error.issues.items.[INDEX].param","typeLabel":"string | null"},"message":{"type":"string","description":"Why the field was rejected.","isRequired":true,"uniqueKey":"error.issues.items.[INDEX].message","typeLabel":"string"}},"required":["param","message"],"uniqueKey":"error.issues.items.[INDEX]","typeLabel":"object"},"description":"Present on an invalid_request whose input failed validation: each failing field and why, at most 10.","uniqueKey":"error.issues","typeLabel":"object[]"}},"required":["code","message","doc_url"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>","doc_url":"\u003cstring>","issues":[{"param":"\u003cstring>","message":"\u003cstring>"}]}}}},"exampleType":"generated"}},"exampleType":"generated"},"6d8e997d-fb9a-4c86-a911-6108ce8efdc2":{"description":"You are not authorized to access this resource. Ask a workspace owner to perform this action or to grant the key's creator access.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"doc_url":{"type":"string","isRequired":true,"uniqueKey":"error.doc_url","typeLabel":"string"},"issues":{"type":"array","items":{"type":"object","properties":{"param":{"oneOf":[{"type":"string","description":"Dotted path to the failing field within the request body, query or path, e.g. \"name\" or \"variants.0.available\"; null when the rule covers the whole input.","isRequired":true,"uniqueKey":"error.issues.items.[INDEX].param.oneOf.0","typeLabel":"string"},{"type":"null","description":"Dotted path to the failing field within the request body, query or path, e.g. \"name\" or \"variants.0.available\"; null when the rule covers the whole input.","isRequired":true,"uniqueKey":"error.issues.items.[INDEX].param.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"error.issues.items.[INDEX].param","typeLabel":"string | null"},"message":{"type":"string","description":"Why the field was rejected.","isRequired":true,"uniqueKey":"error.issues.items.[INDEX].message","typeLabel":"string"}},"required":["param","message"],"uniqueKey":"error.issues.items.[INDEX]","typeLabel":"object"},"description":"Present on an invalid_request whose input failed validation: each failing field and why, at most 10.","uniqueKey":"error.issues","typeLabel":"object[]"}},"required":["code","message","doc_url"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>","doc_url":"\u003cstring>","issues":[{"param":"\u003cstring>","message":"\u003cstring>"}]}}}},"exampleType":"generated"}},"exampleType":"generated"},"d5ef4843-be8a-49c0-9e87-578153677727":{"description":"Not Found. The resource may not exist, this key may lack the required scope, or the key's creator may have lost access. Check the key's scopes in Replo Settings and the creator's project or workspace access; a workspace owner can grant access.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"doc_url":{"type":"string","isRequired":true,"uniqueKey":"error.doc_url","typeLabel":"string"},"issues":{"type":"array","items":{"type":"object","properties":{"param":{"oneOf":[{"type":"string","description":"Dotted path to the failing field within the request body, query or path, e.g. \"name\" or \"variants.0.available\"; null when the rule covers the whole input.","isRequired":true,"uniqueKey":"error.issues.items.[INDEX].param.oneOf.0","typeLabel":"string"},{"type":"null","description":"Dotted path to the failing field within the request body, query or path, e.g. \"name\" or \"variants.0.available\"; null when the rule covers the whole input.","isRequired":true,"uniqueKey":"error.issues.items.[INDEX].param.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"error.issues.items.[INDEX].param","typeLabel":"string | null"},"message":{"type":"string","description":"Why the field was rejected.","isRequired":true,"uniqueKey":"error.issues.items.[INDEX].message","typeLabel":"string"}},"required":["param","message"],"uniqueKey":"error.issues.items.[INDEX]","typeLabel":"object"},"description":"Present on an invalid_request whose input failed validation: each failing field and why, at most 10.","uniqueKey":"error.issues","typeLabel":"object[]"}},"required":["code","message","doc_url"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>","doc_url":"\u003cstring>","issues":[{"param":"\u003cstring>","message":"\u003cstring>"}]}}}},"exampleType":"generated"}},"exampleType":"generated"},"c219c058-9634-4bdd-8121-f0dce14a71fb":{"description":"The resource is in a conflicting state.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"doc_url":{"type":"string","isRequired":true,"uniqueKey":"error.doc_url","typeLabel":"string"},"issues":{"type":"array","items":{"type":"object","properties":{"param":{"oneOf":[{"type":"string","description":"Dotted path to the failing field within the request body, query or path, e.g. \"name\" or \"variants.0.available\"; null when the rule covers the whole input.","isRequired":true,"uniqueKey":"error.issues.items.[INDEX].param.oneOf.0","typeLabel":"string"},{"type":"null","description":"Dotted path to the failing field within the request body, query or path, e.g. \"name\" or \"variants.0.available\"; null when the rule covers the whole input.","isRequired":true,"uniqueKey":"error.issues.items.[INDEX].param.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"error.issues.items.[INDEX].param","typeLabel":"string | null"},"message":{"type":"string","description":"Why the field was rejected.","isRequired":true,"uniqueKey":"error.issues.items.[INDEX].message","typeLabel":"string"}},"required":["param","message"],"uniqueKey":"error.issues.items.[INDEX]","typeLabel":"object"},"description":"Present on an invalid_request whose input failed validation: each failing field and why, at most 10.","uniqueKey":"error.issues","typeLabel":"object[]"}},"required":["code","message","doc_url"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>","doc_url":"\u003cstring>","issues":[{"param":"\u003cstring>","message":"\u003cstring>"}]}}}},"exampleType":"generated"}},"exampleType":"generated"},"308cbe10-a32d-4436-aa12-a72c56309cc4":{"description":"File content exceeds the 10 MiB limit.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"doc_url":{"type":"string","isRequired":true,"uniqueKey":"error.doc_url","typeLabel":"string"},"issues":{"type":"array","items":{"type":"object","properties":{"param":{"oneOf":[{"type":"string","description":"Dotted path to the failing field within the request body, query or path, e.g. \"name\" or \"variants.0.available\"; null when the rule covers the whole input.","isRequired":true,"uniqueKey":"error.issues.items.[INDEX].param.oneOf.0","typeLabel":"string"},{"type":"null","description":"Dotted path to the failing field within the request body, query or path, e.g. \"name\" or \"variants.0.available\"; null when the rule covers the whole input.","isRequired":true,"uniqueKey":"error.issues.items.[INDEX].param.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"error.issues.items.[INDEX].param","typeLabel":"string | null"},"message":{"type":"string","description":"Why the field was rejected.","isRequired":true,"uniqueKey":"error.issues.items.[INDEX].message","typeLabel":"string"}},"required":["param","message"],"uniqueKey":"error.issues.items.[INDEX]","typeLabel":"object"},"description":"Present on an invalid_request whose input failed validation: each failing field and why, at most 10.","uniqueKey":"error.issues","typeLabel":"object[]"}},"required":["code","message","doc_url"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>","doc_url":"\u003cstring>","issues":[{"param":"\u003cstring>","message":"\u003cstring>"}]}}}},"exampleType":"generated"}},"exampleType":"generated"},"1f23342a-79ae-4271-b048-78fe40ddcb6a":{"description":"Too many requests. Please retry after the time indicated by the Retry-After header.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"doc_url":{"type":"string","isRequired":true,"uniqueKey":"error.doc_url","typeLabel":"string"},"issues":{"type":"array","items":{"type":"object","properties":{"param":{"oneOf":[{"type":"string","description":"Dotted path to the failing field within the request body, query or path, e.g. \"name\" or \"variants.0.available\"; null when the rule covers the whole input.","isRequired":true,"uniqueKey":"error.issues.items.[INDEX].param.oneOf.0","typeLabel":"string"},{"type":"null","description":"Dotted path to the failing field within the request body, query or path, e.g. \"name\" or \"variants.0.available\"; null when the rule covers the whole input.","isRequired":true,"uniqueKey":"error.issues.items.[INDEX].param.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"error.issues.items.[INDEX].param","typeLabel":"string | null"},"message":{"type":"string","description":"Why the field was rejected.","isRequired":true,"uniqueKey":"error.issues.items.[INDEX].message","typeLabel":"string"}},"required":["param","message"],"uniqueKey":"error.issues.items.[INDEX]","typeLabel":"object"},"description":"Present on an invalid_request whose input failed validation: each failing field and why, at most 10.","uniqueKey":"error.issues","typeLabel":"object[]"}},"required":["code","message","doc_url"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>","doc_url":"\u003cstring>","issues":[{"param":"\u003cstring>","message":"\u003cstring>"}]}}}},"exampleType":"generated"}},"exampleType":"generated"},"3ae779c7-5c7b-4556-a24e-bbbe1c3dbcf6":{"description":"An internal error occurred.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"doc_url":{"type":"string","isRequired":true,"uniqueKey":"error.doc_url","typeLabel":"string"},"issues":{"type":"array","items":{"type":"object","properties":{"param":{"oneOf":[{"type":"string","description":"Dotted path to the failing field within the request body, query or path, e.g. \"name\" or \"variants.0.available\"; null when the rule covers the whole input.","isRequired":true,"uniqueKey":"error.issues.items.[INDEX].param.oneOf.0","typeLabel":"string"},{"type":"null","description":"Dotted path to the failing field within the request body, query or path, e.g. \"name\" or \"variants.0.available\"; null when the rule covers the whole input.","isRequired":true,"uniqueKey":"error.issues.items.[INDEX].param.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"error.issues.items.[INDEX].param","typeLabel":"string | null"},"message":{"type":"string","description":"Why the field was rejected.","isRequired":true,"uniqueKey":"error.issues.items.[INDEX].message","typeLabel":"string"}},"required":["param","message"],"uniqueKey":"error.issues.items.[INDEX]","typeLabel":"object"},"description":"Present on an invalid_request whose input failed validation: each failing field and why, at most 10.","uniqueKey":"error.issues","typeLabel":"object[]"}},"required":["code","message","doc_url"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>","doc_url":"\u003cstring>","issues":[{"param":"\u003cstring>","message":"\u003cstring>"}]}}}},"exampleType":"generated"}},"exampleType":"generated"},"5506ab58-4796-4832-92c5-63f535da9917":{"description":"Service temporarily unavailable.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"doc_url":{"type":"string","isRequired":true,"uniqueKey":"error.doc_url","typeLabel":"string"},"issues":{"type":"array","items":{"type":"object","properties":{"param":{"oneOf":[{"type":"string","description":"Dotted path to the failing field within the request body, query or path, e.g. \"name\" or \"variants.0.available\"; null when the rule covers the whole input.","isRequired":true,"uniqueKey":"error.issues.items.[INDEX].param.oneOf.0","typeLabel":"string"},{"type":"null","description":"Dotted path to the failing field within the request body, query or path, e.g. \"name\" or \"variants.0.available\"; null when the rule covers the whole input.","isRequired":true,"uniqueKey":"error.issues.items.[INDEX].param.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"error.issues.items.[INDEX].param","typeLabel":"string | null"},"message":{"type":"string","description":"Why the field was rejected.","isRequired":true,"uniqueKey":"error.issues.items.[INDEX].message","typeLabel":"string"}},"required":["param","message"],"uniqueKey":"error.issues.items.[INDEX]","typeLabel":"object"},"description":"Present on an invalid_request whose input failed validation: each failing field and why, at most 10.","uniqueKey":"error.issues","typeLabel":"object[]"}},"required":["code","message","doc_url"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>","doc_url":"\u003cstring>","issues":[{"param":"\u003cstring>","message":"\u003cstring>"}]}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"dd25cadb-7314-4be4-acba-84ea66af0a9c":{"bearerAuth":{"type":"http","scheme":"bearer","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"64e807d5-00d8-4c1e-bcbc-ab2b938bd979":{"url":"https://api.replo.app/v1"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"replo-agent-docs","siteName":"Replo","title":"Create a task - Replo","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-07T06:26:00.314Z","originalFileLocation":"api-reference/tasks/create-a-task.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=\"application-name\" content=\"Replo\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/replo-agent-docs/xh07b3GEWcoH57dd/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/replo-agent-docs/xh07b3GEWcoH57dd/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/replo-agent-docs/xh07b3GEWcoH57dd/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/replo-agent-docs/xh07b3GEWcoH57dd/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/replo-agent-docs/xh07b3GEWcoH57dd/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/replo-agent-docs/xh07b3GEWcoH57dd/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/replo-agent-docs/xh07b3GEWcoH57dd/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/replo-agent-docs/xh07b3GEWcoH57dd/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/replo-agent-docs/xh07b3GEWcoH57dd/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create a task - Replo\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Replo\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.replo.app/api-reference/tasks/create-a-task\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://replo-agent-docs.mintlify.site/_mintlify/api/og/v2?division=Tasks\u0026amp;title=Create+a+task\u0026amp;theme=27c71acfde8236b7d408c27f\u0026amp;signature=4a3b533c3286af7a7ec643554a5cd20a6c77bb2e1c1f2b723bfec6a375cc9828\">\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=\"Create a task - Replo\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://replo-agent-docs.mintlify.site/_mintlify/api/og/v2?division=Tasks\u0026amp;title=Create+a+task\u0026amp;theme=27c71acfde8236b7d408c27f\u0026amp;signature=4a3b533c3286af7a7ec643554a5cd20a6c77bb2e1c1f2b723bfec6a375cc9828\">\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=\"/mintlify-assets/_mintlify/favicons/replo-agent-docs/xh07b3GEWcoH57dd/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Replo\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#274AE2\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.replo.app/api-reference/tasks/create-a-task\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/tasks/create-a-task.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.replo.app/#organization\",\"name\":\"Replo\",\"url\":\"https://docs.replo.app\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/replo-agent-docs/NFnfdLlAm3qJcc0U/logo/light.svg?fit=max\u0026auto=format\u0026n=NFnfdLlAm3qJcc0U\u0026q=85\u0026s=67cd8b3a8123594574eb6f94e14a385d\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.replo.app#website\",\"name\":\"Replo\",\"url\":\"https://docs.replo.app\",\"publisher\":{\"@id\":\"https://docs.replo.app/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.replo.app/api-reference/tasks/create-a-task#webpage\",\"url\":\"https://docs.replo.app/api-reference/tasks/create-a-task\",\"name\":\"Create a task\",\"dateModified\":\"2026-11-07T06:26:00.314Z\",\"isPartOf\":{\"@id\":\"https://docs.replo.app#website\"},\"breadcrumb\":{\"@id\":\"https://docs.replo.app/api-reference/tasks/create-a-task#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.replo.app/api-reference/tasks/create-a-task#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Endpoints\",\"item\":\"https://docs.replo.app/api-reference/agent/create-an-agent-session\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Tasks\",\"item\":\"https://docs.replo.app/api-reference/tasks/list-tasks\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Create a task\",\"item\":\"https://docs.replo.app/api-reference/tasks/create-a-task\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.replo.app/api-reference/tasks/create-a-task#apireference\",\"headline\":\"Create a task\",\"name\":\"Create a task\",\"url\":\"https://docs.replo.app/api-reference/tasks/create-a-task\",\"mainEntityOfPage\":{\"@id\":\"https://docs.replo.app/api-reference/tasks/create-a-task#webpage\"},\"dateModified\":\"2026-11-07T06:26:00.314Z\",\"publisher\":{\"@id\":\"https://docs.replo.app/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.replo.app#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Replo\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Replo","nav":{"global":{"anchors":[{"anchor":"Announcements","icon":"megaphone","href":"https://www.replo.app/changelog"},{"anchor":"Request a Feature","icon":"rocket","href":"https://feedback.replo.app/"}]},"tabs":[{"tab":"Getting started","pages":[{"title":"Getting started","href":""}]},{"tab":"Features","pages":[{"title":"Features","href":"/apps/website-builder"}]},{"tab":"Prompting","pages":[{"title":"Prompting","href":"/prompt-engineering/prompting-101"}]},{"tab":"Commerce","pages":[{"title":"Commerce","href":"/commerce/introduction"}]},{"tab":"Integrations","pages":[{"title":"Integrations","href":"/integrations/introduction"}]},{"tab":"Glossary","pages":[{"title":"Glossary","href":"/glossary"}]},{"tab":"MCP","pages":[{"title":"MCP","href":"/mcp/get-started"}]},{"tab":"Developers","pages":[{"title":"Developers","href":"/git/overview"}]},{"tab":"API Reference","groups":[{"group":"Overview","pages":[{"title":"Introduction","href":"/api-reference/introduction"},{"title":"Versioning","href":"/api-reference/versioning"},{"title":"Analytics tables","href":"/api-reference/analytics-tables"},{"title":"Errors","href":"/api-reference/errors"}]},{"group":"Endpoints","pages":[{"group":"Agent","pages":[{"title":"Create an agent session","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /agent/sessions","href":"/api-reference/agent/create-an-agent-session"},{"title":"Get agent session status","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /agent/sessions/{sessionId}","href":"/api-reference/agent/get-agent-session-status"},{"title":"Abort an agent session","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /agent/sessions/{sessionId}/abort","href":"/api-reference/agent/abort-an-agent-session"},{"title":"Resolve a pending agent interaction","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /agent/sessions/{sessionId}/interactions/{interactionId}/resolve","href":"/api-reference/agent/resolve-a-pending-agent-interaction"},{"title":"Send a message to an agent session","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /agent/sessions/{sessionId}/messages","href":"/api-reference/agent/send-a-message-to-an-agent-session"}]},{"group":"Analytics","pages":[{"title":"Run a read-only analytics query for a project","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /analytics/query","href":"/api-reference/analytics/run-a-read-only-analytics-query-for-a-project"}]},{"group":"Api-keys","pages":[{"title":"Mint a Replo API key with repository scopes. type user (the default) follows your live access to every project, for a coding agent such as Codex or Claude Code; type project reaches only projectIds, for CI or automation. Requires the api_keys.write scope when called with an API key.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api-keys","href":"/api-reference/api-keys/mint-a-replo-api-key-with-repository-scopes-type-user-the-default-follows-your-live-access-to-every-project-for-a-coding-agent-such-as-codex-or-claude-code;-type-project-reaches-only-projectids-for-ci-or-automation-requires-the-api_keyswrite-scope-when-called-with-an-api-key"}]},{"group":"Assets","pages":[{"title":"List assets. Pass next_cursor back as cursor to read the next page; semantic searches return one ranked page, so next_cursor is always null when searchTerm is set.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /assets","href":"/api-reference/assets/list-assets-pass-next_cursor-back-as-cursor-to-read-the-next-page;-semantic-searches-return-one-ranked-page-so-next_cursor-is-always-null-when-searchterm-is-set"},{"title":"Import an asset","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /assets/import","href":"/api-reference/assets/import-an-asset"}]},{"group":"Brand","pages":[{"title":"Read the project's saved brand: business facts, overviews, colors, fonts, marks, personas, tagged context files, brand imagery, and imported Figma frames. A project without a brand returns the empty brand at version 0.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /brand","href":"/api-reference/brand/read-the-projects-saved-brand:-business-facts-overviews-colors-fonts-marks-personas-tagged-context-files-brand-imagery-and-imported-figma-frames-a-project-without-a-brand-returns-the-empty-brand-at-version-0"},{"title":"Change the saved brand with ops applied in order, or import it from a public website or a Figma file with url. Every op is validated before anything is written: an invalid op returns status invalid with the issues and the op's expected shape, and nothing changes. An import returns at once with status running and an importId; GET /v1/brand reports it, under extraction for a website or figmaDesigns for a Figma file, until it is completed or failed. A Figma file needs Figma connected in Replo: without it the call returns action_required with a connectUrl for the user to connect it. Calls with url have a daily cap per project, whether or not they start an import; past it the call returns 429 until UTC midnight, and ops still work.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /brand","href":"/api-reference/brand/change-the-saved-brand-with-ops-applied-in-order-or-import-it-from-a-public-website-or-a-figma-file-with-url-every-op-is-validated-before-anything-is-written:-an-invalid-op-returns-status-invalid-with-the-issues-and-the-ops-expected-shape-and-nothing-changes-an-import-returns-at-once-with-status-running-and-an-importid;-get-v1brand-reports-it-under-extraction-for-a-website-or-figmadesigns-for-a-figma-file-until-it-is-completed-or-failed-a-figma-file-needs-figma-connected-in-replo:-without-it-the-call-returns-action_required-with-a-connecturl-for-the-user-to-connect-it-calls-with-url-have-a-daily-cap-per-project-whether-or-not-they-start-an-import;-past-it-the-call-returns-429-until-utc-midnight-and-ops-still-work"}]},{"group":"Comment-threads","pages":[{"title":"List the comment threads on one file, artifact, site or site page, order, or asset, with all their comments. Pass exactly one of fileId, folderId, siteId, orderId or assetId. Returns every matching thread in one page.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /comment-threads","href":"/api-reference/comment-threads/list-the-comment-threads-on-one-file-artifact-site-or-site-page-order-or-asset-with-all-their-comments-pass-exactly-one-of-fileid-folderid-siteid-orderid-or-assetid-returns-every-matching-thread-in-one-page"},{"title":"Start a comment thread on a file, site page, order, or asset. The comment is attributed to the API key's creator.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /comment-threads","href":"/api-reference/comment-threads/start-a-comment-thread-on-a-file-site-page-order-or-asset-the-comment-is-attributed-to-the-api-keys-creator"},{"title":"Get a comment thread with all its comments.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /comment-threads/{threadId}","href":"/api-reference/comment-threads/get-a-comment-thread-with-all-its-comments"},{"title":"Resolve or re-open a comment thread.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /comment-threads/{threadId}","href":"/api-reference/comment-threads/resolve-or-re-open-a-comment-thread"},{"title":"Reply to an open comment thread. Resolved threads must be re-opened first.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /comment-threads/{threadId}/comments","href":"/api-reference/comment-threads/reply-to-an-open-comment-thread-resolved-threads-must-be-re-opened-first"}]},{"group":"Custom-domains","pages":[{"title":"List custom domains for a site","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /custom-domains","href":"/api-reference/custom-domains/list-custom-domains-for-a-site"},{"title":"Connect a custom domain to a site","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /custom-domains","href":"/api-reference/custom-domains/connect-a-custom-domain-to-a-site"},{"title":"Get a custom domain","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /custom-domains/{customDomainId}","href":"/api-reference/custom-domains/get-a-custom-domain"},{"title":"Delete a custom domain","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /custom-domains/{customDomainId}","href":"/api-reference/custom-domains/delete-a-custom-domain"},{"title":"Check DNS and activate a pending custom domain. Returns the domain's current state; callers poll this endpoint until status is active, or equivalently until both is_pending and is_stale are false.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /custom-domains/{customDomainId}/verify","href":"/api-reference/custom-domains/check-dns-and-activate-a-pending-custom-domain-returns-the-domains-current-state;-callers-poll-this-endpoint-until-status-is-active-or-equivalently-until-both-is_pending-and-is_stale-are-false"}]},{"group":"Feedback","pages":[{"title":"Report a Replo bug","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /feedback/bugs","href":"/api-reference/feedback/report-a-replo-bug"},{"title":"Submit a Replo feature request","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /feedback/feature-requests","href":"/api-reference/feedback/submit-a-replo-feature-request"}]},{"group":"Files","pages":[{"title":"List documents in a project folder. Omit parentId for My Files.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /files","href":"/api-reference/files/list-documents-in-a-project-folder-omit-parentid-for-my-files"},{"title":"Create a folder or store up to 10 MiB of file content. Asset sources copy without deleting the asset. Name conflicts never overwrite.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /files","href":"/api-reference/files/create-a-folder-or-store-up-to-10-mib-of-file-content-asset-sources-copy-without-deleting-the-asset-name-conflicts-never-overwrite"},{"title":"Retrieve file or folder metadata.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /files/{fileId}","href":"/api-reference/files/retrieve-file-or-folder-metadata"},{"title":"Rename or move an entry within its project. A null parentId moves to My Files. Name conflicts never overwrite.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /files/{fileId}","href":"/api-reference/files/rename-or-move-an-entry-within-its-project-a-null-parentid-moves-to-my-files-name-conflicts-never-overwrite"},{"title":"Read complete small UTF-8 documents or get a download URL valid for 15 minutes.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /files/{fileId}/content","href":"/api-reference/files/read-complete-small-utf-8-documents-or-get-a-download-url-valid-for-15-minutes"},{"title":"List who can open a file: its owner, team, link, and people access, plus access inherited from parent folders. Owner or workspace admin only.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /files/{fileId}/sharing","href":"/api-reference/files/list-who-can-open-a-file:-its-owner-team-link-and-people-access-plus-access-inherited-from-parent-folders-owner-or-workspace-admin-only"},{"title":"Set access for the team, the link, or project members by email, all at once. A null role removes access given on this file; inherited folder access stays and audiences not listed keep theirs. Owner or workspace admin only.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /files/{fileId}/sharing","href":"/api-reference/files/set-access-for-the-team-the-link-or-project-members-by-email-all-at-once-a-null-role-removes-access-given-on-this-file;-inherited-folder-access-stays-and-audiences-not-listed-keep-theirs-owner-or-workspace-admin-only"}]},{"group":"InsightsReports","pages":[{"title":"List accessible Insights reports","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /insights-reports","href":"/api-reference/insightsreports/list-accessible-insights-reports"},{"title":"Read an Insights report definition and defaults","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /insights-reports/{reportId}","href":"/api-reference/insightsreports/read-an-insights-report-definition-and-defaults"},{"title":"Run saved Insights report queries","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /insights-reports/{reportId}/query","href":"/api-reference/insightsreports/run-saved-insights-report-queries"}]},{"group":"Orders","pages":[{"title":"List orders","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /orders","href":"/api-reference/orders/list-orders"},{"title":"Get an order","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /orders/{orderId}","href":"/api-reference/orders/get-an-order"}]},{"group":"Products","pages":[{"title":"List products","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /products","href":"/api-reference/products/list-products"},{"title":"Create a product","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /products","href":"/api-reference/products/create-a-product"},{"title":"Get a product","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /products/{productId}","href":"/api-reference/products/get-a-product"},{"title":"Update a product","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /products/{productId}","href":"/api-reference/products/update-a-product"},{"title":"Set per-variant inventory tracking flags and stock counts","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /products/{productId}/inventory","href":"/api-reference/products/set-per-variant-inventory-tracking-flags-and-stock-counts"}]},{"group":"Projects","pages":[{"title":"List the Replo projects this connector can act on, with their ids and names.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /projects","href":"/api-reference/projects/list-the-replo-projects-this-connector-can-act-on-with-their-ids-and-names"},{"title":"Create a Replo project in a workspace.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /projects","href":"/api-reference/projects/create-a-replo-project-in-a-workspace"},{"title":"Get a Replo project's settings, including which provider powers checkout.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /projects/{projectId}","href":"/api-reference/projects/get-a-replo-projects-settings-including-which-provider-powers-checkout"},{"title":"Update a Replo project's settings. Switching checkoutProvider changes what the Checkout button does on every published site.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /projects/{projectId}","href":"/api-reference/projects/update-a-replo-projects-settings-switching-checkoutprovider-changes-what-the-checkout-button-does-on-every-published-site"}]},{"group":"Shared-previews","pages":[{"title":"Create or recover a durable shared preview link to a site route in the API key owner's agent workspace. Start an agent session in the project before sharing. Page availability is checked when the link is opened, not when it is created.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /shared-previews","href":"/api-reference/shared-previews/create-or-recover-a-durable-shared-preview-link-to-a-site-route-in-the-api-key-owners-agent-workspace-start-an-agent-session-in-the-project-before-sharing-page-availability-is-checked-when-the-link-is-opened-not-when-it-is-created"},{"title":"Revoke a shared preview link. The link stops rendering immediately; revoking an already-revoked link succeeds.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /shared-previews/{sharedPreviewId}","href":"/api-reference/shared-previews/revoke-a-shared-preview-link-the-link-stops-rendering-immediately;-revoking-an-already-revoked-link-succeeds"}]},{"group":"Sites","pages":[{"title":"List sites for a project","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /sites","href":"/api-reference/sites/list-sites-for-a-project"},{"title":"Create a site with its git repository","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /sites","href":"/api-reference/sites/create-a-site-with-its-git-repository"},{"title":"Update a site","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /sites/{siteId}","href":"/api-reference/sites/update-a-site"},{"title":"Publish a site","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /sites/{siteId}/publish","href":"/api-reference/sites/publish-a-site"}]},{"group":"Tasks","pages":[{"title":"List tasks","description":null,"deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /tasks","href":"/api-reference/tasks/list-tasks"},{"title":"Create a task","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /tasks","href":"/api-reference/tasks/create-a-task"},{"title":"Get a task","description":null,"deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /tasks/{taskId}","href":"/api-reference/tasks/get-a-task"},{"title":"Delete a task","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /tasks/{taskId}","href":"/api-reference/tasks/delete-a-task"},{"title":"Update a task","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /tasks/{taskId}","href":"/api-reference/tasks/update-a-task"}]}]},{"group":"Changelog","pages":[{"title":"Version 2026-10-29","href":"/api-reference/changelog/2026-10-29"},{"title":"Version 2026-10-05","href":"/api-reference/changelog/2026-10-05"},{"title":"Version 2026-09-08","href":"/api-reference/changelog/2026-09-08"},{"title":"Version 2026-08-21","href":"/api-reference/changelog/2026-08-21"},{"title":"Version 2026-08-07","href":"/api-reference/changelog/2026-08-07"}]}]}]},"basePath":"","title":"Create a task - Replo","buildId":"dpl_8LJbrAiZvr1K98WQNZXCyY5AvT34","deploymentId":"dpl_8LJbrAiZvr1K98WQNZXCyY5AvT34","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-i2a3QZ8E.js","utils-ChLwp8m0.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DRktVTDc.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-CA2pEs4T.js","snippetPresets-ClQ6XrKD.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-Ct_Lv36y.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-Cn2PYw9e.js","shallow-rkyymjXQ.js","getApiPlaygroundDisplay-BB9vkXtE.js","CodeSnippet-Bm5RU7m1.js","CodeSnippets-BgU9Deuz.js","Page-BUDYNlhG.js","getPastedJson-BD-6NNum.js","icon-8Z6tud2e.js","MethodPill-Tuzr4g3V.js","DuplicateIcon-0ceWFYhN.js","createIcon-FBXow_ST.js","DynamicMarkdown-CD8713Yy.js","SectionHeading-7zgzQbH-.js","axios-vUo_bRtp.js","Markdown-D7Ofw1oz.js","clsx-eKJ4rcii.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CwjSCXIK.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-9EK5IAXV.js"]}