Work Management on Skedulo Documentation

Create Job

Mon, 01 Jan 0001 00:00:00 +0000

Overview

Creates a new job

Category: Work Management

Use this action to create a new job. Provide the region and duration at minimum. Optionally set schedule times, location, and metadata.

Request

Parameter	Type	Required	Description	Example
`RegionId`	string	Yes	The ID of the region for the job	`0014ccb7-73ad-40e1-9282-2c492a0f313a`
`Duration`	integer	Yes	Job duration in minutes	`60`
`JobType`	string	No	Job type from the Jobs.Type picklist	`Break Fix`
`Description`	string	No	Job description	`Fix broken equipment`
`Start`	string	No	Start time in ISO 8601 UTC	`2026-01-15T09:00:00.000Z`
`End`	string	No	End time in ISO 8601 UTC	`2026-01-15T10:00:00.000Z`
`Address`	string	No	Job address	`123 Main St, Sydney NSW 2000`
`LocationId`	string	No	The ID of the location	`0014ccb7-73ad-40e1-9282-2c492a0f313a`
`AccountId`	string	No	The ID of the account	`0014ccb7-73ad-40e1-9282-2c492a0f313a`
`ContactId`	string	No	The ID of the contact	`0014ccb7-73ad-40e1-9282-2c492a0f313a`
`Urgency`	string	No	Job urgency from the Jobs.Urgency picklist	`Normal`
`GeoLatitude`	number	No	Latitude coordinate	`-33.8688`
`GeoLongitude`	number	No	Longitude coordinate	`151.2093`

Response

This action’s output is available as $createJob in JSONata expressions. See Response format for the standard result.data / result.errors structure and error handling patterns.

Duplicate Job

Mon, 01 Jan 0001 00:00:00 +0000

Overview

Duplicates an existing job with configurable options

Category: Work Management

Use this action to duplicate an existing job with configurable options. The new job’s dates are offset by the specified number of days. The original job must have a region. The new job is created with status “Queued” and unlocked. Optionally copies allocations, products, tags, and tasks from the original.

Create Resource Requirement

Mon, 01 Jan 0001 00:00:00 +0000

Overview

Creates a resource requirement for a job

Category: Work Management

Use this action to create a resource requirement for a job. Resource requirements define how many resources a job needs and optionally specify time windows and duration.

Request

Parameter	Type	Required	Description	Example
`JobId`	string	Yes	The ID of the job	`0014ccb7-73ad-40e1-9282-2c492a0f313a`
`Quantity`	integer	Yes	Number of resources required	`2`
`Description`	string	No	Description of the requirement	`Electrician needed`
`Duration`	integer	No	Duration in minutes	`120`
`ScheduledStart`	string	No	Scheduled start in ISO 8601 UTC	`2026-01-15T09:00:00.000Z`
`ScheduledEnd`	string	No	Scheduled end in ISO 8601 UTC	`2026-01-15T11:00:00.000Z`
`Status`	string	No	Requirement status from the ResourceRequirements.Status picklist	`Open`

Response

This action’s output is available as $createResourceRequirement in JSONata expressions. See Response format for the standard result.data / result.errors structure and error handling patterns.

Move Job Time

Mon, 01 Jan 0001 00:00:00 +0000

Overview

Moves a job’s start time by a specified offset

Category: Work Management

Use this action to shift a job’s start time by an offset value. A positive offset moves the start time later; a negative offset moves it earlier. The unit defaults to minutes if not provided (also accepts hours or days). Optionally supply a new duration in minutes. The end time is automatically recalculated from the new start time and the duration.

Cancel Jobs

Mon, 01 Jan 0001 00:00:00 +0000

Overview

Cancels one or more jobs

Category: Work Management

Use this action to cancel one or more jobs. Jobs that are Complete, already Canceled, or Locked cannot be canceled. Partial success is possible: cancellable jobs will be canceled and non-cancellable jobs will appear in errors. Set notifyResources to true to send a cancellation notification to allocated resources.

Lock/Unlock Jobs

Mon, 01 Jan 0001 00:00:00 +0000

Overview

Locks or unlocks one or more jobs

Category: Work Management

Use this action to lock or unlock one or more jobs. Locked jobs cannot be edited or have their schedule changed.

Request

Parameter	Type	Required	Description	Example
`ids`	array of string	Yes	Job UIDs to lock or unlock Min items: 1	`["0014ccb7-73ad-40e1-9282-2c492a0f313a"]`
`locked`	boolean	Yes	true to lock (prevent editing), false to unlock	`true`

Response

This action’s output is available as $lockJobs in JSONata expressions. See Response format for the standard result.data / result.errors structure and error handling patterns.