Update Todo Status
Authentication
This endpoint requires a valid Bearer token with thedebts:write scope.
# Update agreement
curl -X PUT https://getbill.io/external-api/v1/todos/agreement/enc_456/status \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"debt_status_id": "enc_5",
"plan_months": 12,
"plan_start_date": "2024-02-01",
"first_payment_amount": 150.00
}'
# Update dispute
curl -X PUT https://getbill.io/external-api/v1/todos/debtor_request/enc_234/status \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"status": "validated",
"admin_notes": "Verified payment was received"
}'
Path Parameters
| Parameter | Type | Description |
|---|---|---|
type | string | Todo type: agreement, debtor_request, or ai_detection |
id | string | Encrypted todo ID |
Request Body (Agreement)
| Field | Type | Required | Description |
|---|---|---|---|
debt_status_id | string | No | Encrypted debt status ID |
plan_months | integer | No | Duration of payment plan in months |
plan_start_date | string | No | Start date of payment plan (ISO 8601) |
first_payment_amount | float | No | Amount of first payment |
Request Body (Dispute)
| Field | Type | Required | Description |
|---|---|---|---|
status | string | No | New status: suggested, validated, or rejected |
admin_notes | string | No | Additional notes about the status change |