Skip to main content

Update Agreement Terms

Change the wording for this booking only. The supplier's saved template is untouched and every other booking keeps its own terms.

PATCH /v1/bookings/{id}/agreement

Authenticationโ€‹

Requires a valid API key with agreements:write scope.

Path Parametersโ€‹

ParameterTypeDescription
idintegerBooking ID

Request Bodyโ€‹

FieldTypeRequiredDescription
termsstringYesThe full wording, max 20,000 characters. Merge tags are not re-resolved โ€” send the finished text
titlestringNoDocument heading, max 120 characters

Request Exampleโ€‹

curl -X PATCH "https://app.equipdash.com/api/v1/bookings/4821/agreement" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"terms": "This agreement is between Example Outfitters and Jane Doe. Items must be returned by 5:00 PM on August 16."
}'

Responseโ€‹

Returns 200 OK with the updated agreement resource.

Errorsโ€‹

StatusCodeWhen
403agreements_disabledThe business has rental agreements switched off
409agreement_not_applicableThe booking has no rental items, so it has no agreement
404resource_not_foundNo booking with that ID belongs to this API key's business
422validation_errorterms missing, empty, or over 20,000 characters
422agreement_update_failedThe agreement is already signed โ€” signed wording is frozen