Create, update, or delete a job

curl --request POST \
  --url https://my.propops.app/api/jobs/manage \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "job_title": "Boiler Service - Unit 001",
  "job_description": "Annual boiler service required.",
  "priority_id": 2,
  "status_id": 1,
  "job_type_id": 3,
  "address_id": 5,
  "csrf_token": "abc123def456",
  "agent_id": 10,
  "contractor_id": 20,
  "tenants_ids": [
    100,
    101
  ],
  "job_total_budget": 250,
  "contractor_budget": 180,
  "vat_percentage": 20,
  "total_amount": 216,
  "date_works_start_date": "2024-06-01",
  "date_works_end_date": "2024-06-02",
  "time_range_id": 2,
  "access_details": "Key safe code 1234.",
  "works_order_ref": "WO-001",
  "invoice_no": "INV-001",
  "quote_no": "QT-001",
  "private_contact_name": "Contact_001",
  "private_contact_email": "contact001@example.com"
}
'

import requests

url = "https://my.propops.app/api/jobs/manage"

payload = {
    "job_title": "Boiler Service - Unit 001",
    "job_description": "Annual boiler service required.",
    "priority_id": 2,
    "status_id": 1,
    "job_type_id": 3,
    "address_id": 5,
    "csrf_token": "abc123def456",
    "agent_id": 10,
    "contractor_id": 20,
    "tenants_ids": [100, 101],
    "job_total_budget": 250,
    "contractor_budget": 180,
    "vat_percentage": 20,
    "total_amount": 216,
    "date_works_start_date": "2024-06-01",
    "date_works_end_date": "2024-06-02",
    "time_range_id": 2,
    "access_details": "Key safe code 1234.",
    "works_order_ref": "WO-001",
    "invoice_no": "INV-001",
    "quote_no": "QT-001",
    "private_contact_name": "Contact_001",
    "private_contact_email": "contact001@example.com"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    job_title: 'Boiler Service - Unit 001',
    job_description: 'Annual boiler service required.',
    priority_id: 2,
    status_id: 1,
    job_type_id: 3,
    address_id: 5,
    csrf_token: 'abc123def456',
    agent_id: 10,
    contractor_id: 20,
    tenants_ids: [100, 101],
    job_total_budget: 250,
    contractor_budget: 180,
    vat_percentage: 20,
    total_amount: 216,
    date_works_start_date: '2024-06-01',
    date_works_end_date: '2024-06-02',
    time_range_id: 2,
    access_details: 'Key safe code 1234.',
    works_order_ref: 'WO-001',
    invoice_no: 'INV-001',
    quote_no: 'QT-001',
    private_contact_name: 'Contact_001',
    private_contact_email: 'contact001@example.com'
  })
};

fetch('https://my.propops.app/api/jobs/manage', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://my.propops.app/api/jobs/manage",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'job_title' => 'Boiler Service - Unit 001',
    'job_description' => 'Annual boiler service required.',
    'priority_id' => 2,
    'status_id' => 1,
    'job_type_id' => 3,
    'address_id' => 5,
    'csrf_token' => 'abc123def456',
    'agent_id' => 10,
    'contractor_id' => 20,
    'tenants_ids' => [
        100,
        101
    ],
    'job_total_budget' => 250,
    'contractor_budget' => 180,
    'vat_percentage' => 20,
    'total_amount' => 216,
    'date_works_start_date' => '2024-06-01',
    'date_works_end_date' => '2024-06-02',
    'time_range_id' => 2,
    'access_details' => 'Key safe code 1234.',
    'works_order_ref' => 'WO-001',
    'invoice_no' => 'INV-001',
    'quote_no' => 'QT-001',
    'private_contact_name' => 'Contact_001',
    'private_contact_email' => 'contact001@example.com'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://my.propops.app/api/jobs/manage"

	payload := strings.NewReader("{\n  \"job_title\": \"Boiler Service - Unit 001\",\n  \"job_description\": \"Annual boiler service required.\",\n  \"priority_id\": 2,\n  \"status_id\": 1,\n  \"job_type_id\": 3,\n  \"address_id\": 5,\n  \"csrf_token\": \"abc123def456\",\n  \"agent_id\": 10,\n  \"contractor_id\": 20,\n  \"tenants_ids\": [\n    100,\n    101\n  ],\n  \"job_total_budget\": 250,\n  \"contractor_budget\": 180,\n  \"vat_percentage\": 20,\n  \"total_amount\": 216,\n  \"date_works_start_date\": \"2024-06-01\",\n  \"date_works_end_date\": \"2024-06-02\",\n  \"time_range_id\": 2,\n  \"access_details\": \"Key safe code 1234.\",\n  \"works_order_ref\": \"WO-001\",\n  \"invoice_no\": \"INV-001\",\n  \"quote_no\": \"QT-001\",\n  \"private_contact_name\": \"Contact_001\",\n  \"private_contact_email\": \"contact001@example.com\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://my.propops.app/api/jobs/manage")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"job_title\": \"Boiler Service - Unit 001\",\n  \"job_description\": \"Annual boiler service required.\",\n  \"priority_id\": 2,\n  \"status_id\": 1,\n  \"job_type_id\": 3,\n  \"address_id\": 5,\n  \"csrf_token\": \"abc123def456\",\n  \"agent_id\": 10,\n  \"contractor_id\": 20,\n  \"tenants_ids\": [\n    100,\n    101\n  ],\n  \"job_total_budget\": 250,\n  \"contractor_budget\": 180,\n  \"vat_percentage\": 20,\n  \"total_amount\": 216,\n  \"date_works_start_date\": \"2024-06-01\",\n  \"date_works_end_date\": \"2024-06-02\",\n  \"time_range_id\": 2,\n  \"access_details\": \"Key safe code 1234.\",\n  \"works_order_ref\": \"WO-001\",\n  \"invoice_no\": \"INV-001\",\n  \"quote_no\": \"QT-001\",\n  \"private_contact_name\": \"Contact_001\",\n  \"private_contact_email\": \"contact001@example.com\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://my.propops.app/api/jobs/manage")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"job_title\": \"Boiler Service - Unit 001\",\n  \"job_description\": \"Annual boiler service required.\",\n  \"priority_id\": 2,\n  \"status_id\": 1,\n  \"job_type_id\": 3,\n  \"address_id\": 5,\n  \"csrf_token\": \"abc123def456\",\n  \"agent_id\": 10,\n  \"contractor_id\": 20,\n  \"tenants_ids\": [\n    100,\n    101\n  ],\n  \"job_total_budget\": 250,\n  \"contractor_budget\": 180,\n  \"vat_percentage\": 20,\n  \"total_amount\": 216,\n  \"date_works_start_date\": \"2024-06-01\",\n  \"date_works_end_date\": \"2024-06-02\",\n  \"time_range_id\": 2,\n  \"access_details\": \"Key safe code 1234.\",\n  \"works_order_ref\": \"WO-001\",\n  \"invoice_no\": \"INV-001\",\n  \"quote_no\": \"QT-001\",\n  \"private_contact_name\": \"Contact_001\",\n  \"private_contact_email\": \"contact001@example.com\"\n}"

response = http.request(request)
puts response.read_body

{
  "success": true,
  "message": "Operation completed successfully"
}

{
  "success": true,
  "message": "Operation completed successfully",
  "job_id": 1001,
  "job_uuid": "550e8400-e29b-41d4-a716-446655440001",
  "job_ref": "JOB-001"
}

{
  "success": false,
  "error": "Missing required parameter: job_title."
}

{
  "success": false,
  "error": "Unauthorized. Valid Bearer token required."
}

{
  "success": false,
  "error": "You do not have permission to perform this action."
}

Job Management

Create, update, or delete a job

Perform write operations on jobs. The action field in the request body determines the operation:

create — Create a new job
update — Update an existing job (requires uuid)
delete — Permanently delete a job and all associated data (requires uuid)
send_assignment_notification — Notify the assigned contractor
restore_commit — Restore job to a previous state
restore_archived_file — Restore an archived file

Required permission: api.jobs.manage.manage

POST

api

jobs

manage

Create, update, or delete a job

curl --request POST \
  --url https://my.propops.app/api/jobs/manage \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "job_title": "Boiler Service - Unit 001",
  "job_description": "Annual boiler service required.",
  "priority_id": 2,
  "status_id": 1,
  "job_type_id": 3,
  "address_id": 5,
  "csrf_token": "abc123def456",
  "agent_id": 10,
  "contractor_id": 20,
  "tenants_ids": [
    100,
    101
  ],
  "job_total_budget": 250,
  "contractor_budget": 180,
  "vat_percentage": 20,
  "total_amount": 216,
  "date_works_start_date": "2024-06-01",
  "date_works_end_date": "2024-06-02",
  "time_range_id": 2,
  "access_details": "Key safe code 1234.",
  "works_order_ref": "WO-001",
  "invoice_no": "INV-001",
  "quote_no": "QT-001",
  "private_contact_name": "Contact_001",
  "private_contact_email": "contact001@example.com"
}
'

import requests

url = "https://my.propops.app/api/jobs/manage"

payload = {
    "job_title": "Boiler Service - Unit 001",
    "job_description": "Annual boiler service required.",
    "priority_id": 2,
    "status_id": 1,
    "job_type_id": 3,
    "address_id": 5,
    "csrf_token": "abc123def456",
    "agent_id": 10,
    "contractor_id": 20,
    "tenants_ids": [100, 101],
    "job_total_budget": 250,
    "contractor_budget": 180,
    "vat_percentage": 20,
    "total_amount": 216,
    "date_works_start_date": "2024-06-01",
    "date_works_end_date": "2024-06-02",
    "time_range_id": 2,
    "access_details": "Key safe code 1234.",
    "works_order_ref": "WO-001",
    "invoice_no": "INV-001",
    "quote_no": "QT-001",
    "private_contact_name": "Contact_001",
    "private_contact_email": "contact001@example.com"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    job_title: 'Boiler Service - Unit 001',
    job_description: 'Annual boiler service required.',
    priority_id: 2,
    status_id: 1,
    job_type_id: 3,
    address_id: 5,
    csrf_token: 'abc123def456',
    agent_id: 10,
    contractor_id: 20,
    tenants_ids: [100, 101],
    job_total_budget: 250,
    contractor_budget: 180,
    vat_percentage: 20,
    total_amount: 216,
    date_works_start_date: '2024-06-01',
    date_works_end_date: '2024-06-02',
    time_range_id: 2,
    access_details: 'Key safe code 1234.',
    works_order_ref: 'WO-001',
    invoice_no: 'INV-001',
    quote_no: 'QT-001',
    private_contact_name: 'Contact_001',
    private_contact_email: 'contact001@example.com'
  })
};

fetch('https://my.propops.app/api/jobs/manage', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://my.propops.app/api/jobs/manage",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'job_title' => 'Boiler Service - Unit 001',
    'job_description' => 'Annual boiler service required.',
    'priority_id' => 2,
    'status_id' => 1,
    'job_type_id' => 3,
    'address_id' => 5,
    'csrf_token' => 'abc123def456',
    'agent_id' => 10,
    'contractor_id' => 20,
    'tenants_ids' => [
        100,
        101
    ],
    'job_total_budget' => 250,
    'contractor_budget' => 180,
    'vat_percentage' => 20,
    'total_amount' => 216,
    'date_works_start_date' => '2024-06-01',
    'date_works_end_date' => '2024-06-02',
    'time_range_id' => 2,
    'access_details' => 'Key safe code 1234.',
    'works_order_ref' => 'WO-001',
    'invoice_no' => 'INV-001',
    'quote_no' => 'QT-001',
    'private_contact_name' => 'Contact_001',
    'private_contact_email' => 'contact001@example.com'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://my.propops.app/api/jobs/manage"

	payload := strings.NewReader("{\n  \"job_title\": \"Boiler Service - Unit 001\",\n  \"job_description\": \"Annual boiler service required.\",\n  \"priority_id\": 2,\n  \"status_id\": 1,\n  \"job_type_id\": 3,\n  \"address_id\": 5,\n  \"csrf_token\": \"abc123def456\",\n  \"agent_id\": 10,\n  \"contractor_id\": 20,\n  \"tenants_ids\": [\n    100,\n    101\n  ],\n  \"job_total_budget\": 250,\n  \"contractor_budget\": 180,\n  \"vat_percentage\": 20,\n  \"total_amount\": 216,\n  \"date_works_start_date\": \"2024-06-01\",\n  \"date_works_end_date\": \"2024-06-02\",\n  \"time_range_id\": 2,\n  \"access_details\": \"Key safe code 1234.\",\n  \"works_order_ref\": \"WO-001\",\n  \"invoice_no\": \"INV-001\",\n  \"quote_no\": \"QT-001\",\n  \"private_contact_name\": \"Contact_001\",\n  \"private_contact_email\": \"contact001@example.com\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://my.propops.app/api/jobs/manage")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"job_title\": \"Boiler Service - Unit 001\",\n  \"job_description\": \"Annual boiler service required.\",\n  \"priority_id\": 2,\n  \"status_id\": 1,\n  \"job_type_id\": 3,\n  \"address_id\": 5,\n  \"csrf_token\": \"abc123def456\",\n  \"agent_id\": 10,\n  \"contractor_id\": 20,\n  \"tenants_ids\": [\n    100,\n    101\n  ],\n  \"job_total_budget\": 250,\n  \"contractor_budget\": 180,\n  \"vat_percentage\": 20,\n  \"total_amount\": 216,\n  \"date_works_start_date\": \"2024-06-01\",\n  \"date_works_end_date\": \"2024-06-02\",\n  \"time_range_id\": 2,\n  \"access_details\": \"Key safe code 1234.\",\n  \"works_order_ref\": \"WO-001\",\n  \"invoice_no\": \"INV-001\",\n  \"quote_no\": \"QT-001\",\n  \"private_contact_name\": \"Contact_001\",\n  \"private_contact_email\": \"contact001@example.com\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://my.propops.app/api/jobs/manage")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"job_title\": \"Boiler Service - Unit 001\",\n  \"job_description\": \"Annual boiler service required.\",\n  \"priority_id\": 2,\n  \"status_id\": 1,\n  \"job_type_id\": 3,\n  \"address_id\": 5,\n  \"csrf_token\": \"abc123def456\",\n  \"agent_id\": 10,\n  \"contractor_id\": 20,\n  \"tenants_ids\": [\n    100,\n    101\n  ],\n  \"job_total_budget\": 250,\n  \"contractor_budget\": 180,\n  \"vat_percentage\": 20,\n  \"total_amount\": 216,\n  \"date_works_start_date\": \"2024-06-01\",\n  \"date_works_end_date\": \"2024-06-02\",\n  \"time_range_id\": 2,\n  \"access_details\": \"Key safe code 1234.\",\n  \"works_order_ref\": \"WO-001\",\n  \"invoice_no\": \"INV-001\",\n  \"quote_no\": \"QT-001\",\n  \"private_contact_name\": \"Contact_001\",\n  \"private_contact_email\": \"contact001@example.com\"\n}"

response = http.request(request)
puts response.read_body

{
  "success": true,
  "message": "Operation completed successfully"
}

{
  "success": true,
  "message": "Operation completed successfully",
  "job_id": 1001,
  "job_uuid": "550e8400-e29b-41d4-a716-446655440001",
  "job_ref": "JOB-001"
}

{
  "success": false,
  "error": "Missing required parameter: job_title."
}

{
  "success": false,
  "error": "Unauthorized. Valid Bearer token required."
}

{
  "success": false,
  "error": "You do not have permission to perform this action."
}

Authorizations

Authorization

string

header

required

All API requests must include a valid Bearer token in the Authorization header. Tokens are 64-character SHA-256 session hashes issued by the PropOps authentication system.

Example:

Authorization: Bearer a1b2c3d4e5f6...

Body

application/json

Option 1
Option 2

job_title

string

required

Example:

"Boiler Service - Unit 001"

job_description

string

required

Example:

"Annual boiler service required."

priority_id

integer

required

Example:

2

status_id

integer

required

Example:

1

job_type_id

integer

required

Example:

3

address_id

integer

required

Example:

5

csrf_token

string

required

Example:

"abc123def456"

agent_id

integer | null

Example:

10

contractor_id

integer | null

Example:

20

tenants_ids

integer[]

Example:

[100, 101]

job_total_budget

number<float> | null

Example:

250

contractor_budget

number<float> | null

Example:

180

vat_percentage

number<float> | null

Example:

20

total_amount

number<float> | null

Example:

216

date_works_start_date

string<date> | null

Example:

"2024-06-01"

date_works_end_date

string<date> | null

Example:

"2024-06-02"

time_range_id

integer | null

Example:

2

access_details

string | null

Example:

"Key safe code 1234."

works_order_ref

string | null

Example:

"WO-001"

invoice_no

string | null

Example:

"INV-001"

quote_no

string | null

Example:

"QT-001"

private_contact_name

string | null

Example:

"Contact_001"

private_contact_email

string<email> | null

Example:

"contact001@example.com"

Response

Job updated/deleted successfully

success

boolean

Example:

true

message

string

Example:

"Operation completed successfully"

List or retrieve jobs Toggle pin status of a job

Overview

Authentication

Jobs

Calendar

Users

Contractors

Tenants

Agents & Branches

SLA

Dashboard

Analytics

Reports

Financial

Notifications & Notices

Email

WhatsApp

Search

Security

GDPR & Privacy

System

Administration

Automation

Weather

Create, update, or delete a job

Authorizations

Body

Response