Skip to main content
POST
/
api
/
jobs
/
manage
Create, update, or delete a job
curl --request POST \
  --url https://api.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"
}
'
{
  "success": true,
  "message": "Operation completed successfully"
}

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
​
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"