Suggest Resources

Overview

Suggests optimal resources for a job

Category: Scheduling

Use this action to suggest optimal resources for a job. Ranks candidates by location, skills, and availability. Only jobId is required: schedule times and region are auto-fetched from the job. Pass resourceIds to limit candidates, or omit to consider all resources. The job must have start/end times and a region.

Request

Parameter Type Required Description Example
jobId string Yes The ID of the job to suggest resources for 0014ccb7-73ad-40e1-9282-2c492a0f313a
resourceIds array of string No Candidate resource IDs. Omit to consider all resources; do not pass an empty array.
Min items: 1		 ["00148d32-10ef-4264-adfe-0ff3ece68d92"]

Response

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

Field Type Description
result.data.suggestions array of object Ranked resource suggestions for the job
result.data.error string Error message if suggestions could not be generated for the job

Example output:

{
  "suggestions": [
    {
      "resourceId": "00148d32-10ef-4264-adfe-0ff3ece68d92",
      "score": 95
    }
  ]
}