Cron API

Source: daemon/proto/hostcraft/v1/cron.proto

CronService

CronService manages per-account scheduled jobs (systemd timers). REST: /api/v1/cron/jobs.

Method	REST route	Permission	Streaming
ListCronJobs	GET /api/v1/cron/jobs	CronJobRead	unary
CreateCronJob	POST /api/v1/cron/jobs	CronJobCreate	unary
GetCronJob	GET /api/v1/cron/jobs/{id}	CronJobRead	unary
UpdateCronJob	PATCH /api/v1/cron/jobs/{id}	CronJobUpdate	unary
DeleteCronJob	DELETE /api/v1/cron/jobs/{id}	CronJobDelete	unary
EnableCronJob	POST /api/v1/cron/jobs/{id}/enable	CronJobEnable	unary
DisableCronJob	POST /api/v1/cron/jobs/{id}/disable	CronJobDisable	unary
RunCronJobNow	POST /api/v1/cron/jobs/{id}/run	CronJobRunNow	unary
GetCronJobHistory	GET /api/v1/cron/jobs/{id}/history	CronJobHistory	unary

ListCronJobs

/hostcraft.v1.CronService/ListCronJobs

• Request: ListCronJobsRequest
• Response: ListCronJobsResponse

CreateCronJob

/hostcraft.v1.CronService/CreateCronJob

• Request: CreateCronJobRequest
• Response: CreateCronJobResponse

GetCronJob

/hostcraft.v1.CronService/GetCronJob

• Request: GetCronJobRequest
• Response: CronJob

UpdateCronJob

/hostcraft.v1.CronService/UpdateCronJob

• Request: UpdateCronJobRequest
• Response: CronJob

DeleteCronJob

/hostcraft.v1.CronService/DeleteCronJob

• Request: DeleteCronJobRequest
• Response: WorkflowAccepted

EnableCronJob

/hostcraft.v1.CronService/EnableCronJob

• Request: EnableCronJobRequest
• Response: CronJob

DisableCronJob

/hostcraft.v1.CronService/DisableCronJob

• Request: DisableCronJobRequest
• Response: CronJob

RunCronJobNow

/hostcraft.v1.CronService/RunCronJobNow

• Request: RunCronJobNowRequest
• Response: RunCronJobNowResponse

GetCronJobHistory

/hostcraft.v1.CronService/GetCronJobHistory

• Request: GetCronJobHistoryRequest
• Response: GetCronJobHistoryResponse

Messages

CreateCronJobRequest

Field	Type	Number	Description
account_id	string	1	-
schedule_cron	string	2	-
command	string	3	-
working_dir	string	4	-
env	map<string, string>	5	-
enabled	bool	6	-
description	string	7	-

CreateCronJobResponse

Field	Type	Number	Description
job	CronJob	1	-
workflow_id	string	2	-

CronExecution

Field	Type	Number	Description
id	string	1	-
cron_id	string	2	-
account_id	string	3	-
started_at	google.protobuf.Timestamp	4	-
finished_at	google.protobuf.Timestamp	5	-
exit_code	int64	6	-
stdout	string	7	-
stderr	string	8	-
trigger	string	9	-

CronJob

Field	Type	Number	Description
id	string	1	-
account_id	string	2	-
schedule_cron	string	3	-
command	string	4	-
working_dir	string	5	-
env	map<string, string>	6	-
enabled	bool	7	-
description	string	8	-
created_at	google.protobuf.Timestamp	9	-
updated_at	google.protobuf.Timestamp	10	-
last_run_at	google.protobuf.Timestamp	11	-

DeleteCronJobRequest

Field	Type	Number	Description
id	string	1	-

DisableCronJobRequest

Field	Type	Number	Description
id	string	1	-

EnableCronJobRequest

Field	Type	Number	Description
id	string	1	-

GetCronJobHistoryRequest

Field	Type	Number	Description
id	string	1	-
last_n	int64	2	-

GetCronJobHistoryResponse

Field	Type	Number	Description
executions	repeated CronExecution	1	-

GetCronJobRequest

Field	Type	Number	Description
id	string	1	-

ListCronJobsRequest

Field	Type	Number	Description
account_id	string	1	-

ListCronJobsResponse

Field	Type	Number	Description
jobs	repeated CronJob	1	-

RunCronJobNowRequest

Field	Type	Number	Description
id	string	1	-

RunCronJobNowResponse

Field	Type	Number	Description
execution	CronExecution	1	-

UpdateCronJobRequest

Field	Type	Number	Description
id	string	1	-
schedule_cron	optional string	2	-
command	optional string	3	-
working_dir	optional string	4	-
env	map<string, string>	5	replaces the environment when non-empty
enabled	optional bool	6	-
description	optional string	7	-

WorkflowAccepted

WorkflowAccepted is the body of every 202 response that only starts a workflow saga. Follow progress with WorkflowService.StreamWorkflow.

Field	Type	Number	Description
workflow_id	string	1	-