Create job

POST

/jobs/

Creates a job on the schedule and returns its ID and printable number.

Requires a site and start and end times. When number_of_days is greater
than zero, creates a multi-day job spanning consecutive days.

Request

Body Params application/jsonRequired

Example

{
    "start_time": "2024-07-15T09:00:00+10:00",
    "end_time": "2024-07-15T11:00:00+10:00",
    "unscheduled": false,
    "scheduled": true,
    "number_of_days": 1,
    "site": "67",
    "workflow": "87",
    "status": "74",
    "job_types": [
        "74"
    ],
    "workers": [
        "87"
    ],
    "job_notes": "Annual AC tune-up.",
    "purchase_order_number": "PO-2024-0042",
    "project": "80",
    "external_id": "JOB-1001",
    "title": "Annual AC Tune-Up",
    "printable_number": "S1234",
    "business_division": "66",
    "business_entity": "66",
    "custom_fields": [
        {
            "field": "1",
            "value": "R-410A"
        }
    ]
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://app.fieldinsight.com/public-api//jobs/' \
--header 'Content-Type: application/json' \
--data '{
    "start_time": "2024-07-15T09:00:00+10:00",
    "end_time": "2024-07-15T11:00:00+10:00",
    "unscheduled": false,
    "scheduled": true,
    "number_of_days": 1,
    "site": "67",
    "workflow": "87",
    "status": "74",
    "job_types": [
        "74"
    ],
    "workers": [
        "87"
    ],
    "job_notes": "Annual AC tune-up.",
    "purchase_order_number": "PO-2024-0042",
    "project": "80",
    "external_id": "JOB-1001",
    "title": "Annual AC Tune-Up",
    "printable_number": "S1234",
    "business_division": "66",
    "business_entity": "66",
    "custom_fields": [
        {
            "field": "1",
            "value": "R-410A"
        }
    ]
}'

Responses

🟢200OK

application/json

Successful response.

Bodyapplication/json

Example

{
    "id": "7001",
    "printable_number": "S1234"
}

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠404Record Not Found

🟠409

🟠422Parameter Error

🟠429

Modified at 2026-10-30 03:40:11

Get jobs

Update job