Skip to main content
PATCH
/
milestones
/
{id}
Update a milestone by ID
curl --request PATCH \
  --url https://api.zivio.net/api/v3/milestones/{id} \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --header 'zivio-tenant-id: <api-key>' \
  --data '
{
  "milestone": {
    "title": "My New Milestone",
    "rate_cents": "50",
    "rate_ccy": "GBP",
    "due_on": "2023-12-25",
    "details": "Details about the milestone",
    "notes": "Notes about the milestone",
    "comments": "Commentss about the milestone"
  }
}
'
{
  "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": "[email protected]",
    "org_name": "Organisation Ltd",
    "org_id": "567",
    "business_unit": "Public Private Partnerships",
    "division": "Infastructure",
    "department": "Bridges",
    "vetting_status": "PASSED",
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z",
    "custom_fields": {
      "key": "value"
    },
    "has_oversight": "<string>"
  },
  "level_1_approved_at": "2023-11-07T05:31:56Z",
  "level_1_approved_by": {
    "id": "258",
    "first_name": "John",
    "last_name": "Smith",
    "email": "[email protected]",
    "org_name": "Smith Co Ltd",
    "org_id": "200",
    "business_unit": "Public Private Partnerships",
    "division": "Infastructure",
    "department": "Bridges",
    "vetting_status": "PASSED",
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z",
    "custom_fields": {
      "key": "value"
    },
    "has_oversight": "<string>"
  },
  "children": [
    "124"
  ],
  "parents": [
    "14"
  ],
  "custom_fields": {
    "key": "value"
  }
}

Authorizations

​
X-API-Key
string
header
required
​
zivio-tenant-id
string
header
required

Path Parameters

​
id
integer
required

Body

application/json
​
milestone
object

Response

ok

​
id
integer
Example:

"66"

​
title
string
Example:

"Title of Milestone"

​
details
string
Example:

"Details of Milestone"

​
rate
string
Example:

"1500.00"

​
ccy
string
Example:

"GBP"

​
due_on
string<date-time>
​
notes
string
Example:

"some notes relating to the milestone"

​
comments
string
Example:

"some comments relating to the milestone"

​
job_id
integer
Example:

"2669"

​
job_summary
string
Example:

"summary of miestone"

​
created_at
string<date-time>
​
updated_at
string<date-time>
​
status
string
Example:

"open"

​
approved_at
string<date-time>
​
approved_by
object
​
level_1_approved_at
string<date-time>
​
level_1_approved_by
object
​
children
integer[]
​
parents
integer[]
​
custom_fields
object