Croncool Cron Jobs

GetCheck joba executionjob's run history

Fetch aUse boundedthis executionwhen historysomeone forasks onewhether exacta Croncoolcron job idran, mostfailed recentor first.was Returnsslow, executionincluding id,a status,run HTTPjust status,triggered. duration,Returns andrecent timestampruns only;newest responsefirst bodies,with errors,success jobor requestfailure, payloadsHTTP status, duration and credentialstime are(no excluded.response Usebodies), this20 afterby run_jobdefault toand verify100 theat recordedmost. outcomeNot insteadfor ofstarting retryinga automatically.run.

 ⟨6 unchanged words⟩ jobId":{"description":"Job id (uuid) to fetch execution history for","maxLength":128,"minLength":1,"type":"string"},"limit":{"description":"Maximum numberHow ofmany executionsruns to return, (defaultfrom 20,1 maxto 100)100; defaults to 20","maximum":100,"minimum":1,"type ⟨5 unchanged words⟩ 

 ⟨3 unchanged words⟩ additionalProperties":false,"properties":{"executions":{"description":"Runs newest first. Response bodies, error text, job request payloads and credentials are excluded.","items":{"additionalProperties":false,"properties":{" ⟨67 unchanged words⟩ 

 ⟨4 unchanged words⟩ openWorldHint":false,"readOnlyHint":true,"title":"GetCheck joba executionjob's run history"}

GetTrace a workflow run

Fetch oneUse durablethis workflowwhen runsomeone byasks exactwhy projecta iddurable andworkflow run idfailed togetheror withwhere ait boundedis setstuck. ofReturns steps.the Returnsrun's status/timingstatus, metadatatimings and machine error codescode only;plus workflowits inputssteps with status, outputsattempt, errortimings messages,and deploymenterror detailscode, and50 ownershipsteps fieldsby aredefault excluded.and Cross-organization200 idsat aremost. reportedNot asfor notlisting found.runs.

 ⟨6 unchanged words⟩ :{"projectId":{"description":"Project id owningthat owns the run (required)","maxLength":128,"minLength":1,"type ⟨11 unchanged words⟩ :"string"},"stepLimit":{"description":"Maximum numberHow ofmany steps to return, (defaultfrom 50,1 maxto 200)200; defaults to 50","maximum":200,"minimum":1,"type ⟨6 unchanged words⟩ 

 ⟨77 unchanged words⟩ ,"type":"string"},"steps":{"description":"Step status, attempt, timings and machine error code. Workflow inputs, outputs, error messages, deployment details and ownership fields are excluded.","items":{"additionalProperties":false,"properties":{" ⟨60 unchanged words⟩ 200,"type":"array"},"stepsTruncated":{"description":"True when the run has more steps than were returned","type":"boolean"}},"required":[" ⟨6 unchanged words⟩ 

 ⟨4 unchanged words⟩ openWorldHint":false,"readOnlyHint":true,"title":"GetTrace a workflow run"}

List scheduled cron jobs

ListUse athis boundedwhen pagesomeone ofasks Croncoolwhat cron jobs inor thescheduled authenticatedtasks organization,they optionallyhave, filteredor bywhich exactones projectlast id.failed. Returns safeeach schedulingjob's metadataid, andname, schedule, target originsorigin, only;method, requestenabled payloadsstate and credential-bearinglast URLrun paths,status queriesand time, fragments20 per page by default, orwith userinfoa arecursor excluded.for Reusemore. nextCursorNot withfor thea samejob's filterfull torun continue.history.

 ⟨5 unchanged words⟩ ,"properties":{"cursor":{"description":"OpaqueThe nextCursor from anof earlierthe list_jobsprevious callpage with the same projectprojectId; filterabsent for the first page","maxLength":4096,"minLength":1,"type":"string"},"limit":{"description":"MaximumJobs numberper ofpage, jobsfrom to1 returnto (default100;

 ⟨7 unchanged words⟩ {"type":"boolean"},"jobs":{"description":"Job schedules and target origins only. Request payloads and credential-bearing URL paths, queries, fragments and userinfo are excluded.","items":{"additionalProperties":false,"properties":{" ⟨123 unchanged words⟩ :"string"},{"type":"null"}],"description":"Cursor for the next page with the same filters; null on the last page"}},"required":["jobs","hasMore", ⟨3 unchanged words⟩ 

 ⟨5 unchanged words⟩ :false,"readOnlyHint":true,"title":"List scheduled cron jobs"}

List your Croncool projects

ListUse athis boundedwhen setsomeone ofasks which Croncool projects thethey authenticatedhave, useror cana access.project's Returnsid onlyis theneeded. projectReturns each project's id, neededname forand follow-upcreation callstime, display50 name,by default and creation100 time;at workflowmost, callbackwith configurationa andflag secretswhen aremore excluded.exist. Not for listing jobs.

 ⟨5 unchanged words⟩ ,"properties":{"limit":{"description":"Maximum numberHow ofmany projects to return, (defaultfrom 50,1 maxto 100)100; defaults to 50","maximum":100,"minimum":1,"type ⟨3 unchanged words⟩ 

 ⟨3 unchanged words⟩ additionalProperties":false,"properties":{"hasMore":{"description":"True when more projects exist than were returned; there is no cursor","type":"boolean"},"projects":{"description":"Projects the signed-in user can access. Workflow callback configuration and secrets are excluded.","items":{"additionalProperties":false,"properties":{ ⟨36 unchanged words⟩ 

 ⟨5 unchanged words⟩ :false,"readOnlyHint":true,"title":"List your Croncool projects"}

ListCheck webhook subscriptionsdelivery health

List a boundedUse setthis ofwhen webhooksomeone delivery-healthasks recordswhether intheir theCroncool authenticatedwebhooks Croncoolare organizationdelivering, optionallyfailing filteredor bywere exactdisabled. projectReturns id.each Returnssubscription's endpoint originsorigin, event filtersevents, active state, failureconsecutive countsfailures, and delivery times. Fullauto-disabled endpointflag paths/queries,and signinglast secrets,delivery payloadstime, and ownership fields20 areby excluded.default. EndpointsWorks areonly automaticallywith disableda aftersigned-in 20user consecutivesession, failures.not Requiresan aAPI logged-inkey. userNot session,for notchanging theor stdiore-enabling API-keya transport.webhook.

 ⟨5 unchanged words⟩ ,"properties":{"limit":{"description":"Maximum numberHow ofmany subscriptions to return, (defaultfrom 20,1 maxto 100)100; defaults to 20","maximum":100,"minimum":1,"type":"integer"},"projectId":{"description":"Only return subscriptions of this project","maxLength":128, ⟨6 unchanged words⟩ 

 ⟨3 unchanged words⟩ additionalProperties":false,"properties":{"subscriptions":{"description":"Endpoint origins and delivery health; autoDisabled marks a subscription switched off after 20 consecutive failures. Full endpoint paths and queries, signing secrets, payloads and ownership fields are excluded.","items":{"additionalProperties":false,"properties":{" ⟨76 unchanged words⟩ 

 ⟨4 unchanged words⟩ openWorldHint":false,"readOnlyHint":true,"title":"ListCheck webhook subscriptionsdelivery health"}

List aUse boundedthis pagewhen ofsomeone durableasks workflowabout runsrecent foror onefailed exactruns Croncoolof projecta id,durable optionallyworkflow filteredin bya workflowCroncool nameproject. andReturns status.each Returnsrun's onlyid, runworkflow identityname, status, timings, and machine error code;code, workflownewest inputs,first outputsby default, and20 errorper messagespage arewith excluded.a Reusecursor, nextCursorfilterable withby identicalworkflow filtersand tostatus. continue.Not for one run's steps.

 ⟨5 unchanged words⟩ ,"properties":{"cursor":{"description":"OpaqueThe nextCursor fromof anthe earlierprevious callpage with the same project, workflow, status, and sortsort; filtersabsent for the first page","maxLength":4096,"minLength":1,"type":"string"},"limit":{"description":"MaximumRuns numberper ofpage, runsfrom to1 returnto 

 ⟨14 unchanged words⟩ :"string"},{"type":"null"}],"description":"Cursor for the next page with the same filters; null on the last page"},"runs":{"description":"Run identity, status, timings and machine error code. Workflow inputs, outputs and error messages are excluded.","items":{"additionalProperties":false,"properties":{ ⟨70 unchanged words⟩ 

List durable workflows

ListUse athis boundedwhen setsomeone ofasks which durable workflows for one exacta Croncool project idruns, withor per-statushow many runs are running, pending, completed, failed or cancelled. Returns each workflow's name, run counts andby moststatus recentand last run time.time Workflowfor inputs,one outputsproject, error messages,50 callbackby configuration,default and secrets100 areat excluded.most. Not for individual runs.

 ⟨5 unchanged words⟩ ,"properties":{"limit":{"description":"Maximum numberHow ofmany workflows to return, (defaultfrom 50,1 maxto 100)100; defaults to 50","maximum":100,"minimum":1,"type":"integer"},"projectId":{"description":"Project id whose workflows should be listed (required)","maxLength":128,"minLength":1,"type ⟨5 unchanged words⟩ 

 ⟨3 unchanged words⟩ additionalProperties":false,"properties":{"hasMore":{"description":"True when the project has more workflows than returned","type":"boolean"},"workflows":{"description":"Run counts per workflow. Workflow inputs, outputs, error messages, callback configuration and secrets are excluded.","items":{"additionalProperties":false,"properties":{ ⟨66 unchanged words⟩ 

 ⟨5 unchanged words⟩ :false,"readOnlyHint":true,"title":"List durable workflows"}

Run a cron job now

TriggerUse onethis existingwhen Croncoolsomeone jobasks byto exactrun idor immediately,trigger outsidea itscron schedule.job Thisnow. isReturns destructiveonly underthat hostCroncool reviewinvoked policyit, open-world,not andthe non-idempotent:target's everyresponse. Each call canimmediately sendsends the job's configured request again and cause, downstreamwhich writes,can messageswrite, billing,message or third-party effects. First callbill get_jobdownstream, show the exact job and target origin, anda obtainrepeated thecall user'ssends explicitit confirmation.once Nevermore. retryNot automaticallyfor afterchecking a timeout or ambiguous error; inspect get_job_runsrun's first.result.

 ⟨7 unchanged words⟩ description":"Job id (uuid) of the one job to run immediately","maxLength":128,"minLength":1,"type ⟨5 unchanged words⟩ 

 ⟨11 unchanged words⟩ },"status":{"const":"invoked","description":"Croncool invoked the job; the outcome is recorded in the job's run history","type":"string"}},"required":["status ⟨3 unchanged words⟩ 

 ⟨5 unchanged words⟩ :true,"readOnlyHint":false,"title":"Run a cron job now"}

RenderUse this when someone wants a boundedquick overview foror onedashboard knownof one Croncool projectproject. id.Returns Usean afteroverview list_projects.card Showswith safethe projectproject's metadataname and upcreation totime, 12whether tenant-scopedworkflow jobshosting withis targetset originsup, only;and jobup requestto payloads,12 credential-bearingjobs targetwith paths/queriesschedule, organizationtarget fields,origin and workflowlast callbackrun secretsstatus. areNot excluded.for a job's run history.

 ⟨3 unchanged words⟩ ,"properties":{"projectId":{"description":"Croncool projectProject id to render","maxLength":128,"minLength":1,"type ⟨5 unchanged words⟩ 

 ⟨14 unchanged words⟩ {"type":"boolean"},"jobs":{"description":"Up to 12 of the project jobs. Job request payloads, credential-bearing target paths or queries, organization fields and workflow callback secrets are excluded.","items":{"additionalProperties":false,"properties":{" ⟨119 unchanged words⟩ 

{"destructiveHint":false,"idempotentHint":true,"openWorldHint":false,"readOnlyHint":true,"title":"Show Croncool project overview"}