Complete milestone

POST

/jobs/{id}/milestones/{milestoneId}/complete

curl --request POST \
  --url https://example.com/jobs/example/milestones/example/complete \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: 2489E9AD-2EE2-8E00-8EC9-32D5F69181C0' \
  --data '{ "completionNotes": "example", "photoFileIds": [ "example" ] }'

Who can call it: Owners, Staff and Field users.

curl -X POST "https://spine.example.com/api/jobs/<id>/milestones/<milestoneId>/complete" \
  -H "Cookie: better-auth.session_token=<session>" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" -d '{ … }'

Parameters

Path Parameters

id

required

string

milestoneId

required

string

Header Parameters

Idempotency-Key

required

string format: uuid

A fresh UUID per action. A retry with the same key gets the first answer instead of doing it twice.

Request Body^required

Media typeapplication/json

object

completionNotes

string

nullable

photoFileIds

File ids already uploaded via POST /files.

Array<string>

Example ^generated

{
  "completionNotes": "example",
  "photoFileIds": [
    "example"
  ]
}

Responses

201

400

Validation failed or a business rule was broken; message says what to change.

401

No session, or it has expired: sign in again.

403

The caller’s role, Team rights or ownership don’t allow it, the module is switched off, or their access was removed.

404

No such record in this business.

409

The same Idempotency-Key is still being handled, or the record conflicts with one that exists.

429

Too many requests: wait a minute.

500

Something went wrong on the server; the response carries the request id to report.