How can I get the next time a job is scheduled

[IgnisDa]

Hello! As far as I can see https://dkron.io/api/#operation/showJobByName endpoint does not have any property that will tell me when a job is scheduled to run next. Is it possible or do I have to calculate it manually?

[IgnisDa]

Looks like there is .next property in the actual response, however it is not visible in the API docs. Are the docs not updated to the latest schema?

[IgnisDa]

It is not present in the schema too

dkron/website/static/openapi/openapi.yaml

Lines 393 to 508 in 76876e1

	job:
	required:
	- name
	- schedule
	type: object
	properties:
	name:
	type: string
	description: Name for the job. Use only lower case letters (unicode), digits, underscore and dash.
	readOnly: false
	example: job1
	displayname:
	type: string
	description: Nice name for the job. Optional.
	readOnly: false
	schedule:
	type: string
	description: Cron expression for the job.
	readOnly: false
	example: '@every 10s'
	timezone:
	type: string
	description: Timezone where the job will be executed. By default and when field is set to empty string, the job will run in local time.
	readOnly: false
	example: Europe/Berlin
	owner:
	type: string
	description: Owner of the job
	readOnly: false
	example: Platform Team
	owner_email:
	type: string
	description: Email of the owner
	readOnly: false
	example: platform@example.com
	success_count:
	type: integer
	description: Number of successful executions
	readOnly: true
	error_count:
	type: integer
	description: Number of failed executions
	readOnly: true
	last_success:
	type: string
	description: Last time this job executed successfully
	format: date-time
	readOnly: true
	last_error:
	type: string
	description: Last time this job failed
	format: date-time
	readOnly: true
	disabled:
	type: boolean
	description: Disabled state of the job
	readOnly: false
	tags:
	type: object
	additionalProperties:
	type: string
	description: Target nodes tags of this job
	readOnly: false
	example:
	server: "true"
	metadata:
	type: object
	additionalProperties:
	type: string
	description: Extra metadata tags for this job
	readOnly: false
	example:
	office: Barcelona
	retries:
	type: integer
	description: Number of times to retry a failed job execution
	readOnly: false
	example: 2
	parent_job:
	type: string
	description: The name/id of the job that will trigger the execution of this job
	readOnly: false
	example: parent_job
	dependent_jobs:
	type: array
	description: Array containing the jobs that depends on this one
	readOnly: true
	example:
	- dependent_job
	items:
	type: string
	processors:
	$ref: '#/components/schemas/processors'
	concurrency:
	type: string
	description: Concurrency policy for the job allow/forbid
	readOnly: false
	example: allow
	executor:
	type: string
	description: Executor plugin used to run the job
	readOnly: false
	example: shell
	executor_config:
	type: object
	additionalProperties:
	type: string
	description: Executor plugin parameters
	example:
	command: echo 'Hello from Dkron'
	status:
	type: string
	description: Status of the job
	readOnly: true
	example: success
	description: A Job represents a scheduled task to execute.

[yvanoers]

Apparently we've missed this in the documentation. We should add it as a readonly property.

[vcastellm]

Added to docs