# JobSchedule > Tracon documentation. Tracon is a .NET package family that adds a control > plane on Microsoft Agent Framework, published as NuGet packages that run > inside your own ASP.NET Core application. > > Page: https://tracon.dev/api/tracon.jobschedule/ > Summary: JobSchedule: The schedule record defining when and how a job runs.

Namespace Tracon · Assembly Tracon.Abstractions.dll

The schedule record defining when and how a job runs. ```csharp public sealed record JobSchedule : IEquatable ```

Inheritance: object ← JobSchedule
Implements: IEquatable<JobSchedule>
Inherited Members: object.GetType(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()

## Remarks If `Cron` is left empty, the schedule is triggered only manually (`POST .../trigger`); no automatic next-run time is computed. ## Constructors ### JobSchedule\(\) ```csharp public JobSchedule() ``` ## Properties ### CreatedAt The creation time (UTC). ```csharp public required DateTimeOffset CreatedAt { get; init; } ``` #### Property Value [DateTimeOffset](https://learn.microsoft.com/dotnet/api/system.datetimeoffset) ### CreatedBy The identifier of the user/service that created the schedule. ```csharp public string? CreatedBy { get; init; } ``` #### Property Value [string](https://learn.microsoft.com/dotnet/api/system.string)? ### Cron The five-field cron expression (`minute hour day-of-month month day-of-week`). If [null](https://learn.microsoft.com/dotnet/csharp/language-reference/keywords/null), the schedule is triggered only manually. ```csharp public string? Cron { get; init; } ``` #### Property Value [string](https://learn.microsoft.com/dotnet/api/system.string)? ### Enabled Whether the schedule is enabled. If disabled, it is not triggered automatically. ```csharp public bool Enabled { get; init; } ``` #### Property Value [bool](https://learn.microsoft.com/dotnet/api/system.boolean) ### HandlerKey The key of the [IJobHandler](/api/tracon.ijobhandler/) the jobs this schedule produces are dispatched to. See [JobHandlerKeys](/api/tracon.jobhandlerkeys/). ```csharp public required string HandlerKey { get; init; } ``` #### Property Value [string](https://learn.microsoft.com/dotnet/api/system.string) ### Id The schedule identifier. ```csharp public Guid Id { get; init; } ``` #### Property Value [Guid](https://learn.microsoft.com/dotnet/api/system.guid) ### Lane The lane the jobs this schedule produces run in. See [JobLanes](/api/tracon.joblanes/). Both a cron-dispatched run and a manual `POST .../trigger` inherit this value. ```csharp public string Lane { get; init; } ``` #### Property Value [string](https://learn.microsoft.com/dotnet/api/system.string) ### LastRunAt The last run time (UTC). [null](https://learn.microsoft.com/dotnet/csharp/language-reference/keywords/null) if it never ran. ```csharp public DateTimeOffset? LastRunAt { get; init; } ``` #### Property Value [DateTimeOffset](https://learn.microsoft.com/dotnet/api/system.datetimeoffset)? ### Name The schedule name, unique within the tenant. ```csharp public required string Name { get; init; } ``` #### Property Value [string](https://learn.microsoft.com/dotnet/api/system.string) ### NextRunAt The next automatic run time (UTC). [null](https://learn.microsoft.com/dotnet/csharp/language-reference/keywords/null) if there is no cron. ```csharp public DateTimeOffset? NextRunAt { get; init; } ``` #### Property Value [DateTimeOffset](https://learn.microsoft.com/dotnet/api/system.datetimeoffset)? #### Remarks The worker picks a due schedule by this value and computes every later one itself. A schedule written straight to [IJobScheduleStore](/api/tracon.ijobschedulestore/) with a cron expression must therefore carry its first run time here: saved with [null](https://learn.microsoft.com/dotnet/csharp/language-reference/keywords/null), it never runs. A time at or before now runs it on the worker's next pass. The scheduling API sets it for you. ### Payload The input set or parameters. Interpreted by the job's handler. ```csharp public JsonElement Payload { get; init; } ``` #### Property Value [JsonElement](https://learn.microsoft.com/dotnet/api/system.text.json.jsonelement) #### Remarks An unset payload is stored as the empty JSON array, never as `JsonValueKind.Undefined` or JSON `null`: an undefined value cannot be written as JSON, and SQL Server rejects a `null` literal in a JSON column. Every reader treats the empty array as "no payload". ### TargetName The agent or workflow name to run. ```csharp public required string TargetName { get; init; } ``` #### Property Value [string](https://learn.microsoft.com/dotnet/api/system.string) ### TenantId The tenant the schedule belongs to. ```csharp public required string TenantId { get; init; } ``` #### Property Value [string](https://learn.microsoft.com/dotnet/api/system.string) ### TimeZone The time zone the `Cron` expression is interpreted in. ```csharp public string TimeZone { get; init; } ``` #### Property Value [string](https://learn.microsoft.com/dotnet/api/system.string) ### UpdatedAt The last-updated time (UTC). ```csharp public required DateTimeOffset UpdatedAt { get; init; } ``` #### Property Value [DateTimeOffset](https://learn.microsoft.com/dotnet/api/system.datetimeoffset) ## Methods ### Equals\(object?\) ```csharp public override bool Equals(object? obj) ``` #### Parameters `obj` [object](https://learn.microsoft.com/dotnet/api/system.object)? #### Returns [bool](https://learn.microsoft.com/dotnet/api/system.boolean) ### Equals\(JobSchedule?\) ```csharp public bool Equals(JobSchedule? other) ``` #### Parameters `other` [JobSchedule](/api/tracon.jobschedule/)? #### Returns [bool](https://learn.microsoft.com/dotnet/api/system.boolean) ### GetHashCode\(\) ```csharp public override int GetHashCode() ``` #### Returns [int](https://learn.microsoft.com/dotnet/api/system.int32) ### ToString\(\) ```csharp public override string ToString() ``` #### Returns [string](https://learn.microsoft.com/dotnet/api/system.string) ## Operators ### operator ==\(JobSchedule?, JobSchedule?\) ```csharp public static bool operator ==(JobSchedule? left, JobSchedule? right) ``` #### Parameters `left` [JobSchedule](/api/tracon.jobschedule/)? `right` [JobSchedule](/api/tracon.jobschedule/)? #### Returns [bool](https://learn.microsoft.com/dotnet/api/system.boolean) ### operator \!=\(JobSchedule?, JobSchedule?\) ```csharp public static bool operator !=(JobSchedule? left, JobSchedule? right) ``` #### Parameters `left` [JobSchedule](/api/tracon.jobschedule/)? `right` [JobSchedule](/api/tracon.jobschedule/)? #### Returns [bool](https://learn.microsoft.com/dotnet/api/system.boolean)