Body
-
Name of the case
-
The uuid of the status chosen for the case
-
The case status's new position on the status list. Starting from 1. Only used if you are formatting cases in a kanban layout.
-
Array of account UUIDs
-
UUIDs of groups that will be assigned when the case is created.
-
Timestamp of when the case will be reviewed
-
The uuid of the type chosen for the case
-
Expect value the case will generate in pennies
-
Timestamp of when the case was completed
-
The uuids of the plans that will be associated to the case when it is created. Leave NULL to disassociate all plans from the case.
PUT
/api/v1/cases/{uuid}
curl \
--request PUT 'https://api.plannrcrm.com/api/v1/cases/6ff8f7f6-1eb3-3525-be4a-3932c805afed' \
--header "Authorization: Bearer $ACCESS_TOKEN" \
--header "Content-Type: application/json" \
--header "X-PLANNR-ACCOUNT-UUID: {YOUR_PLANNR_ACCOUNT_UUID}" \
--data '{"name":"Annual review","status":"c09bc13a-af51-40ab-b6c5-c99cad2709c9","status_position":4,"assigned_to_uuids":["34f5cdb5-8d21-491d-b49c-cd14d62f9a25","76e3884b-de03-40e1-8f64-564525edc6f1","51765cdb-06cf-49ff-8b47-3edbc7c705d4"],"group_uuids":["ab284eeb-aaf3-4ddf-9a43-8bac7439d985","69c4c698-4374-4b09-bd87-05257f70d27f","5086e14e-1faa-4bb9-8be7-189be550ea6c"],"review_at":"2026-04-09T17:35:05+01:00","type":"4be3a332-1109-4f6c-8d68-6bc7d079ffa2","value":15099,"completed_at":"2026-04-09T17:35:05+01:00","plans":["a763718d-5404-4c31-a7de-47d5bc24ff3c","2fccff0a-d760-4eb3-8839-3fef2ebe5b49","53b450f8-3c12-4a3c-93f2-ea977a4affeb"]}'
Request examples
# Headers
X-PLANNR-ACCOUNT-UUID: {YOUR_PLANNR_ACCOUNT_UUID}
# Payload
{
"name": "Annual review",
"status": "c09bc13a-af51-40ab-b6c5-c99cad2709c9",
"status_position": 4,
"assigned_to_uuids": [
"34f5cdb5-8d21-491d-b49c-cd14d62f9a25",
"76e3884b-de03-40e1-8f64-564525edc6f1",
"51765cdb-06cf-49ff-8b47-3edbc7c705d4"
],
"group_uuids": [
"ab284eeb-aaf3-4ddf-9a43-8bac7439d985",
"69c4c698-4374-4b09-bd87-05257f70d27f",
"5086e14e-1faa-4bb9-8be7-189be550ea6c"
],
"review_at": "2026-04-09T17:35:05+01:00",
"type": "4be3a332-1109-4f6c-8d68-6bc7d079ffa2",
"value": 15099,
"completed_at": "2026-04-09T17:35:05+01:00",
"plans": [
"a763718d-5404-4c31-a7de-47d5bc24ff3c",
"2fccff0a-d760-4eb3-8839-3fef2ebe5b49",
"53b450f8-3c12-4a3c-93f2-ea977a4affeb"
]
}
Response examples (200)
{
"amount": {
"example": "4000",
"description": "Money amount at their lowest denominator (for example: pennies)"
},
"currency": {
"example": "GBP",
"description": "Currency of the money"
},
"formatted": {
"example": "£40.00",
"description": "Money amount formatted with currency"
}
}