Skip to main content
PUT
/
v1
/
persons
/
{personId}
/
milestones
/
{milestoneId}
Update milestone
curl --request PUT \
  --url https://api.cadanapay.com/v1/persons/{personId}/milestones/{milestoneId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "title": "Design phase",
  "amount": {
    "amount": 10000,
    "currency": "USD"
  },
  "description": "<string>",
  "dueDate": "2026-09-30",
  "documentIds": [
    "8ef9a712-cdae-4110-b1ea-9ba95abbee6e"
  ]
}
'
{
  "code": "invalid_request_body",
  "message": "The request body provided is not valid",
  "params": {
    "field": "Value is invalid."
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

​
X-MultiTenantKey
string

Required when using a Platform API token. The tenant key identifying which business to operate on.

Path Parameters

​
personId
string<uuid>
required

The unique identifier for the person

​
milestoneId
string<uuid>
required

The unique identifier for the milestone

Body

application/json
​
title
string
required
Example:

"Design phase"

​
amount
object
required
​
description
string
​
dueDate
string
Example:

"2026-09-30"

​
documentIds
string<uuid>[]

File ids from POST /v1/files/upload-url (purpose milestone-document); replace the milestone's documents

Response

Milestone updated successfully