AI Scheduler Technician Requirements - Is There a REST API Endpoint?

[khan]

I'm trying to determine whether AI Scheduler Technician Requirements are accessible and editable via the Simpro REST API.

My goal is to bulk manage Technician Requirements on Jobs without using the UI.

The Technician Requirements section contains:

Role Type
Qty
Skills
Licences
Estimated Time (hrs)

Example requirement:

Role Type: Technical Service Support
Qty: 1
Licence: Fire Extinguisher Training
Estimated Time: 5 Hours

While inspecting the web UI, I found Technician Requirements being submitted as:

techReqRowId[0]
techReqRole[0]
techReqQty[0]
techReqSkillIds_0
techReqLicenceIds_0
techReqEstimatedTime[0]

Example values:

techReqRowId[0]=134
techReqRole[0]=Technical Service Support
techReqQty[0]=1
techReqSkillIds_0=[]
techReqLicenceIds_0=[3]
techReqEstimatedTime[0]=5

I have queried the following REST endpoints:

GET /api/v1.0/companies/{companyID}/jobs/{jobID}

GET /api/v1.0/companies/{companyID}/jobs/{jobID}/sections/

GET /api/v1.0/companies/{companyID}/jobs/{jobID}/sections/{sectionID}

GET /api/v1.0/companies/{companyID}/jobs/{jobID}/sections/{sectionID}/costCenters/{costCenterID}

None of these expose anything related to:

Technician Requirements
Role Type
Skills
Licences
Estimated Time
AI Scheduler

The Job endpoint only returns assigned technicians:

"Technicians": []
"Technician": {}

I also found and successfully queried the documented AI Scheduler catalogue endpoints:

GET /api/v1.0/companies/{companyID}/setup/labor/licences/

GET /api/v1.0/companies/{companyID}/setup/labor/skills/

The licence IDs returned by the API exactly match the IDs used by Technician Requirements in the UI.

For example:

techReqLicenceIds_0=[3]

matches:

ID 3 = Fire Extinguisher Training

This suggests that Skills and Licences are exposed through the REST API, but I have not been able to find an endpoint exposing the actual Technician Requirement assignments.

My question is:

Is there currently a REST API endpoint that exposes Technician Requirements for a Job, Section, Cost Centre, Work Order, or AI Scheduler object?

Specifically I am looking for API access to:

Role Type
Qty
Skills
Licences
Estimated Time

Has anyone found a supported endpoint for this, or are Technician Requirements currently only available through the web application? We plan to use the AI scheduler for mass job planning but defeats the purpose if we have such high job volume and difference in time to complete.

Thanks in advance.

[SimproAPITeam]

Hi,
Thanks for the detailed investigation. Your conclusion is correct: Technician Requirements are not currently exposed by the REST API, for reading or writing.
The two catalog endpoints you found, setup/labor/skills and setup/labor/licences, are the correct ones, and the IDs they return are the same IDs the requirements store internally.

Kind regards

[khan]

Thanks for getting back to me, Is there plans to expose this as accessible by API? Is there any way you could recommend accessing this job setting in bulk?

[SimproAPITeam]

Hi Khan,
Some new endpoints related to the AI scheduler function has been released and can be found in our documentation.

Most of the setup is under Sites such as restricted technicians, skills and licences. Found here
https://developer.simprogroup.com/apido ... ite-Skills

There are also added functionality to update skills on contractors and employees
https://developer.simprogroup.com/apido ... yee-Skills

For licence and skill setup see more info here.
https://developer.simprogroup.com/apido ... d-Licences

All these require the AI scheduler to be active on your build to be available.

Regards