Jobs
Update a project by ID
Endpoints
- Welcome
- Bank Accounts
- Bids
- EOIs
- EOI Responses
- Invoices
- Job Approvals
- Jobs
- Milestones
- Offers
- Orgs
- Purchase Orders
- Sales Invoices
- Sales Milestones
- Skill Categories
- Skill Taxonomies
- Skills
- Suppliers
- Supplier Lists
- Users
- Variation Orders
Jobs
Update a project by ID
PATCH
/
jobs
/
{id}
curl --request PATCH \
--url https://api.zivio.net/api/v3/jobs/{id} \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--header 'zivio-tenant-id: <api-key>' \
--data '{
"title": "My Project",
"description": "My Description",
"status": "new",
"start_date": "2023-12-25",
"due_on": "2023-12-25",
"submission_deadline": "2023-11-07T05:31:56Z",
"budget": "500000.00",
"fee": "15.00",
"markup": "4.75",
"ccy": "GBP",
"original_budget": "500000.00",
"rate": "500000.00",
"original_rate": "500000.00",
"award_type": "competition",
"visibility": "public",
"external_id": "ABC-101202",
"custom_fields": {
"key": "value"
},
"milestones_attributes": [
{
"id": "23",
"title": "Title of Milestone",
"details": "Details of Milestone",
"rate": "1500.00",
"ccy": "GBP"
}
],
"job_line_items_attributes": [
{
"id": "254",
"item_id": "2",
"item_type": "item",
"name": "Server",
"manufacturer_name": "Dell",
"manufacturer_part_number": "X15",
"quantity": "7.0",
"uom_id": 123
}
],
"administrator_id": "7158",
"client_id": "7158",
"client_org_id": "7158",
"supplier_id": "77",
"cost_centers": [
{
"cost_center_id": "303",
"job_id": "2606",
"allocation": "100.0"
}
]
}'
{
"id": "2606",
"title": "My Project",
"description": "My Description",
"status": "new",
"start_date": "2023-12-25",
"due_on": "2023-12-25",
"submission_deadline": "2023-11-07T05:31:56Z",
"budget": "500000.00",
"fee": "15.00",
"markup": "4.75",
"ccy": "GBP",
"original_budget": "500000.00",
"rate": "500000.00",
"original_rate": "500000.00",
"award_type": "competition",
"visibility": "public",
"external_id": "ABC-101202",
"is_child": "false",
"is_parent": "false",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"custom_fields": {
"key": "value"
},
"milestones": [
{
"id": "66",
"title": "Title of Milestone",
"details": "Details of Milestone",
"rate": "1500.00",
"ccy": "GBP",
"due_on": "2023-11-07T05:31:56Z",
"notes": "some notes relating to the milestone",
"comments": "some comments relating to the milestone",
"job_id": "2669",
"job_summary": "summary of miestone",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"status": "open",
"approved_at": "2023-11-07T05:31:56Z",
"approved_by": {
"id": "7158",
"first_name": "Jack",
"last_name": "Jones",
"email": "jack_jones@example.com",
"business_unit": "Public Private Partnerships",
"division": "Infastructure",
"department": "Housing",
"org_name": "Organisation Ltd",
"org_id": "567",
"vetting_status": "PASSED",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"custom_fields": {
"key": "value"
},
"has_oversight": "true"
},
"children": [
"124"
],
"parents": [
"14"
],
"custom_fields": {
"key": "value"
}
}
],
"job_line_items": [
{
"id": "66",
"job_id": "6",
"item_type": "item",
"name": "Server",
"manufacturer_name": "Dell",
"manufacturer_part_number": "X15",
"quantity": "10.0",
"quantity_delivered": "0.0",
"quantity_undelivered": "10.0",
"price": "500.00",
"price_ccy": "GBP",
"uom": "<string>",
"net_total_price": "5000.00",
"net_total_price_ccy": "GBP",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"custom_fields": {
"key": "value"
}
}
],
"administrator": {
"id": "7158",
"first_name": "Jack",
"last_name": "Jones",
"email": "jack_jones@example.com",
"org_name": "Organisation Ltd",
"org_id": "567",
"business_unit": "Public Private Partnerships",
"division": "Infastructure",
"department": "Infastructure",
"vetting_status": "PASSED",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"custom_fields": {
"key": "value"
},
"has_oversight": "true"
},
"client": {
"id": "7158",
"first_name": "Jack",
"last_name": "Jones",
"email": "jack_jones@example.com",
"org_name": "Organisation Ltd",
"org_id": "567",
"business_unit": "Public Private Partnerships",
"division": "Infastructure",
"department": "Infastructure",
"vetting_status": "PASSED",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"custom_fields": {
"key": "value"
},
"has_oversight": "true"
},
"client_org": {
"id": "7158",
"name": "Company Ltd",
"is_external_client": "true",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z"
},
"supplier": {
"id": "77",
"name": "Company Inc",
"email": "jack_jones@companyinc.com",
"vetting_status": "PASSED",
"tax_number": "9876543234",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z"
},
"cost_centers": [
{
"cost_center_id": "303",
"job_id": "2606",
"allocation_percentage": "100.0",
"name": "Cost Centre Name",
"code": "Cost Centre Code",
"admin_custom_fields": {
"key": "Field Name",
"value": "Field Value"
},
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z"
}
]
}
Path Parameters
Body
application/json
Response
200
*/*
ok
The response is of type object
.
curl --request PATCH \
--url https://api.zivio.net/api/v3/jobs/{id} \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--header 'zivio-tenant-id: <api-key>' \
--data '{
"title": "My Project",
"description": "My Description",
"status": "new",
"start_date": "2023-12-25",
"due_on": "2023-12-25",
"submission_deadline": "2023-11-07T05:31:56Z",
"budget": "500000.00",
"fee": "15.00",
"markup": "4.75",
"ccy": "GBP",
"original_budget": "500000.00",
"rate": "500000.00",
"original_rate": "500000.00",
"award_type": "competition",
"visibility": "public",
"external_id": "ABC-101202",
"custom_fields": {
"key": "value"
},
"milestones_attributes": [
{
"id": "23",
"title": "Title of Milestone",
"details": "Details of Milestone",
"rate": "1500.00",
"ccy": "GBP"
}
],
"job_line_items_attributes": [
{
"id": "254",
"item_id": "2",
"item_type": "item",
"name": "Server",
"manufacturer_name": "Dell",
"manufacturer_part_number": "X15",
"quantity": "7.0",
"uom_id": 123
}
],
"administrator_id": "7158",
"client_id": "7158",
"client_org_id": "7158",
"supplier_id": "77",
"cost_centers": [
{
"cost_center_id": "303",
"job_id": "2606",
"allocation": "100.0"
}
]
}'
{
"id": "2606",
"title": "My Project",
"description": "My Description",
"status": "new",
"start_date": "2023-12-25",
"due_on": "2023-12-25",
"submission_deadline": "2023-11-07T05:31:56Z",
"budget": "500000.00",
"fee": "15.00",
"markup": "4.75",
"ccy": "GBP",
"original_budget": "500000.00",
"rate": "500000.00",
"original_rate": "500000.00",
"award_type": "competition",
"visibility": "public",
"external_id": "ABC-101202",
"is_child": "false",
"is_parent": "false",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"custom_fields": {
"key": "value"
},
"milestones": [
{
"id": "66",
"title": "Title of Milestone",
"details": "Details of Milestone",
"rate": "1500.00",
"ccy": "GBP",
"due_on": "2023-11-07T05:31:56Z",
"notes": "some notes relating to the milestone",
"comments": "some comments relating to the milestone",
"job_id": "2669",
"job_summary": "summary of miestone",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"status": "open",
"approved_at": "2023-11-07T05:31:56Z",
"approved_by": {
"id": "7158",
"first_name": "Jack",
"last_name": "Jones",
"email": "jack_jones@example.com",
"business_unit": "Public Private Partnerships",
"division": "Infastructure",
"department": "Housing",
"org_name": "Organisation Ltd",
"org_id": "567",
"vetting_status": "PASSED",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"custom_fields": {
"key": "value"
},
"has_oversight": "true"
},
"children": [
"124"
],
"parents": [
"14"
],
"custom_fields": {
"key": "value"
}
}
],
"job_line_items": [
{
"id": "66",
"job_id": "6",
"item_type": "item",
"name": "Server",
"manufacturer_name": "Dell",
"manufacturer_part_number": "X15",
"quantity": "10.0",
"quantity_delivered": "0.0",
"quantity_undelivered": "10.0",
"price": "500.00",
"price_ccy": "GBP",
"uom": "<string>",
"net_total_price": "5000.00",
"net_total_price_ccy": "GBP",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"custom_fields": {
"key": "value"
}
}
],
"administrator": {
"id": "7158",
"first_name": "Jack",
"last_name": "Jones",
"email": "jack_jones@example.com",
"org_name": "Organisation Ltd",
"org_id": "567",
"business_unit": "Public Private Partnerships",
"division": "Infastructure",
"department": "Infastructure",
"vetting_status": "PASSED",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"custom_fields": {
"key": "value"
},
"has_oversight": "true"
},
"client": {
"id": "7158",
"first_name": "Jack",
"last_name": "Jones",
"email": "jack_jones@example.com",
"org_name": "Organisation Ltd",
"org_id": "567",
"business_unit": "Public Private Partnerships",
"division": "Infastructure",
"department": "Infastructure",
"vetting_status": "PASSED",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"custom_fields": {
"key": "value"
},
"has_oversight": "true"
},
"client_org": {
"id": "7158",
"name": "Company Ltd",
"is_external_client": "true",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z"
},
"supplier": {
"id": "77",
"name": "Company Inc",
"email": "jack_jones@companyinc.com",
"vetting_status": "PASSED",
"tax_number": "9876543234",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z"
},
"cost_centers": [
{
"cost_center_id": "303",
"job_id": "2606",
"allocation_percentage": "100.0",
"name": "Cost Centre Name",
"code": "Cost Centre Code",
"admin_custom_fields": {
"key": "Field Name",
"value": "Field Value"
},
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z"
}
]
}