Rental maintenance

Maintenance tickets of managed rentals: WhatsApp intake with photos, AI triage the agent confirms, vendors with dispatch and update links, the owner’s approval above a threshold, SLA timers, the tenant’s confirmation.

GET/v1/maintenance-media/{id}/download

Open a ticket’s file

A 60-second link: photos and videos as their EXIF-free copy, documents after a clean malware scan.

Access: Signed-in members only (web or Android session) — not for API keys. Permission rentals.view.

Parameters

idpathrequired: Id
Opaque record id.

Response · 200

datarequired: object
data.urlrequired: string
data.expires_atrequired: DateTime
Instant in ISO 8601, e.g. 2026-10-03T04:30:00.000Z.
metarequired: object

Request

curl -X GET 'https://api.propzolo.com/v1/maintenance-media/{id}/download' \
  -H 'Authorization: Bearer pz_live_…'

Response example

{
  "data": {
    "url": "string",
    "expires_at": "2026-10-06T05:30:00.000Z"
  },
  "meta": {}
}

Errors

401 No valid session or API key (missing, expired or revoked).
403 The caller lacks the permission, API-key scope or support grant this operation needs.
404 Not found — records of another company are reported the same way.
422 Invalid input; `error.fields` maps field paths to messages.
429 Too many requests; retry after the Retry-After header.
500 Unexpected error; quote `error.request_id` to support.

GET/v1/maintenance-tickets

The maintenance queue

Tickets of the agreements you may see, newest first: open by default; filter by status, urgency, category, agreement, vendor, SLA breached or MT number / title. Keyset pagination.

Access: Signed-in members only (web or Android session) — not for API keys. Permission rentals.view.

Parameters

statusquery: "open" | "all" | "new" | "triaged" | "assigned" | "scheduled" | …
urgencyquery: "emergency" | "high" | "normal" | "low"
categoryquery: "plumbing" | "electrical" | "appliance" | "carpentry" | "pest" | "painting" | …
agreement_idquery: Id
Opaque record id.
vendor_idquery: Id
Opaque record id.
breachedquery: "true" | "false"
qquery: string
cursorquery: string
limitquery: integer

Response · 200

datarequired: array of MaintenanceTicket
metarequired: PageMeta

Request

curl -X GET 'https://api.propzolo.com/v1/maintenance-tickets' \
  -H 'Authorization: Bearer pz_live_…'

Response example

{
  "data": [
    {
      "id": "cmusrceel0000q7kaafxqi1om",
      "number": 0,
      "ref": "string",
      "agreement_id": "cmusrceel0000q7kaafxqi1om",
      "property": {
        "id": "cmusrceel0000q7kaafxqi1om",
        "title": "string"
      },
      "tenant": {
        "id": "cmusrceel0000q7kaafxqi1om",
        "name": "string"
      },
      "source": "whatsapp",
      "title": "string",
      "description": "string",
      "category": "string",
      "urgency": "emergency",
      "status": "new",
      "triage": {
        "category": "string",
        "urgency": "string",
        "vendor_trade": "string",
        "summary": "string",
        "clarifying_question": "string",
        "confidence": 0,
        "flags": [
          "string"
        ],
        "model": "string",
        "at": "string"
      },
      "triage_confirmed": true,
      "vendor": {
        "id": "cmusrceel0000q7kaafxqi1om",
        "name": "string"
      },
      "vendor_trade": "string",
      "scheduled_for": "2026-10-06T05:30:00.000Z",
      "resolved_at": "2026-10-06T05:30:00.000Z",
      "closed_at": "2026-10-06T05:30:00.000Z",
      "closed_via": "string",
      "reopened_count": 0,
      "sla": {
        "respond_due_at": "2026-10-06T05:30:00.000Z",
        "resolve_due_at": "2026-10-06T05:30:00.000Z",
        "state": "met"
      },
      "cost_estimate": 850000000,
      "estimate_note": "string",
      "final_cost": 850000000,
      "payer": "owner",
      "approval": {
        "status": "none",
        "threshold": 850000000,
        "approved_estimate": 850000000,
        "decided_at": "2026-10-06T05:30:00.000Z",
        "note": "string"
      },
      "deposit_charge_status": "none",
      "resolution_note": "string",
      "cancel_reason": "string",
      "assignee_id": "cmusrceel0000q7kaafxqi1om",
      "created_at": "2026-10-06T05:30:00.000Z",
      "updated_at": "2026-10-06T05:30:00.000Z",
      "capabilities": {
        "edit": true
      }
    }
  ],
  "meta": {
    "next_cursor": "string",
    "has_more": true
  }
}

Errors

401 No valid session or API key (missing, expired or revoked).
403 The caller lacks the permission, API-key scope or support grant this operation needs.
422 Invalid input; `error.fields` maps field paths to messages.
429 Too many requests; retry after the Retry-After header.
500 Unexpected error; quote `error.request_id` to support.

POST/v1/maintenance-tickets

Record a repair request

An agent records a request (a call, a visit) on a live agreement. Category and urgency as set count as the confirmed triage; the SLA starts now.

Access: Signed-in members only (web or Android session) — not for API keys. Permission rentals.edit.

Request body

agreement_idrequired: Id
Opaque record id.
titlerequired: string
description: string or null
category: "plumbing" | "electrical" | "appliance" | "carpentry" | "pest" | "painting" | … or null
urgency: "emergency" | "high" | "normal" | "low"

Response · 201

datarequired: MaintenanceTicket
metarequired: object

Request

curl -X POST 'https://api.propzolo.com/v1/maintenance-tickets' \
  -H 'Authorization: Bearer pz_live_…' \
  -H 'Content-Type: application/json' \
  -d '{"agreement_id":"cmusrceel0000q7kaafxqi1om","title":"string","description":"string","category":"plumbing","urgency":"normal"}'

Response example

{
  "data": {
    "id": "cmusrceel0000q7kaafxqi1om",
    "number": 0,
    "ref": "string",
    "agreement_id": "cmusrceel0000q7kaafxqi1om",
    "property": {
      "id": "cmusrceel0000q7kaafxqi1om",
      "title": "string"
    },
    "tenant": {
      "id": "cmusrceel0000q7kaafxqi1om",
      "name": "string"
    },
    "source": "whatsapp",
    "title": "string",
    "description": "string",
    "category": "string",
    "urgency": "emergency",
    "status": "new",
    "triage": {
      "category": "string",
      "urgency": "string",
      "vendor_trade": "string",
      "summary": "string",
      "clarifying_question": "string",
      "confidence": 0,
      "flags": [
        "string"
      ],
      "model": "string",
      "at": "string"
    },
    "triage_confirmed": true,
    "vendor": {
      "id": "cmusrceel0000q7kaafxqi1om",
      "name": "string"
    },
    "vendor_trade": "string",
    "scheduled_for": "2026-10-06T05:30:00.000Z",
    "resolved_at": "2026-10-06T05:30:00.000Z",
    "closed_at": "2026-10-06T05:30:00.000Z",
    "closed_via": "string",
    "reopened_count": 0,
    "sla": {
      "respond_due_at": "2026-10-06T05:30:00.000Z",
      "resolve_due_at": "2026-10-06T05:30:00.000Z",
      "state": "met"
    },
    "cost_estimate": 850000000,
    "estimate_note": "string",
    "final_cost": 850000000,
    "payer": "owner",
    "approval": {
      "status": "none",
      "threshold": 850000000,
      "approved_estimate": 850000000,
      "decided_at": "2026-10-06T05:30:00.000Z",
      "note": "string"
    },
    "deposit_charge_status": "none",
    "resolution_note": "string",
    "cancel_reason": "string",
    "assignee_id": "cmusrceel0000q7kaafxqi1om",
    "created_at": "2026-10-06T05:30:00.000Z",
    "updated_at": "2026-10-06T05:30:00.000Z",
    "capabilities": {
      "edit": true
    }
  },
  "meta": {}
}

Errors

401 No valid session or API key (missing, expired or revoked).
403 The caller lacks the permission, API-key scope or support grant this operation needs.
409 A unique value already exists, a concurrent change won, or the Idempotency-Key is still in use or was sent with a different request.
422 Invalid input; `error.fields` maps field paths to messages.
429 Too many requests; retry after the Retry-After header.
500 Unexpected error; quote `error.request_id` to support.

GET/v1/maintenance-tickets/{id}

A ticket with its timeline and photos

The drawer: the ticket, its timeline, its media (EXIF-free copies as short-lived URLs) and its links.

Access: Signed-in members only (web or Android session) — not for API keys. Permission rentals.view.

Parameters

idpathrequired: Id
Opaque record id.

Response · 200

datarequired: MaintenanceTicketDetail
metarequired: object

Request

curl -X GET 'https://api.propzolo.com/v1/maintenance-tickets/{id}' \
  -H 'Authorization: Bearer pz_live_…'

Response example

{
  "data": {
    "id": "cmusrceel0000q7kaafxqi1om",
    "number": 0,
    "ref": "string",
    "agreement_id": "cmusrceel0000q7kaafxqi1om",
    "property": {
      "id": "cmusrceel0000q7kaafxqi1om",
      "title": "string"
    },
    "tenant": {
      "id": "cmusrceel0000q7kaafxqi1om",
      "name": "string"
    },
    "source": "whatsapp",
    "title": "string",
    "description": "string",
    "category": "string",
    "urgency": "emergency",
    "status": "new",
    "triage": {
      "category": "string",
      "urgency": "string",
      "vendor_trade": "string",
      "summary": "string",
      "clarifying_question": "string",
      "confidence": 0,
      "flags": [
        "string"
      ],
      "model": "string",
      "at": "string"
    },
    "triage_confirmed": true,
    "vendor": {
      "id": "cmusrceel0000q7kaafxqi1om",
      "name": "string"
    },
    "vendor_trade": "string",
    "scheduled_for": "2026-10-06T05:30:00.000Z",
    "resolved_at": "2026-10-06T05:30:00.000Z",
    "closed_at": "2026-10-06T05:30:00.000Z",
    "closed_via": "string",
    "reopened_count": 0,
    "sla": {
      "respond_due_at": "2026-10-06T05:30:00.000Z",
      "resolve_due_at": "2026-10-06T05:30:00.000Z",
      "state": "met"
    },
    "cost_estimate": 850000000,
    "estimate_note": "string",
    "final_cost": 850000000,
    "payer": "owner",
    "approval": {
      "status": "none",
      "threshold": 850000000,
      "approved_estimate": 850000000,
      "decided_at": "2026-10-06T05:30:00.000Z",
      "note": "string"
    },
    "deposit_charge_status": "none",
    "resolution_note": "string",
    "cancel_reason": "string",
    "assignee_id": "cmusrceel0000q7kaafxqi1om",
    "created_at": "2026-10-06T05:30:00.000Z",
    "updated_at": "2026-10-06T05:30:00.000Z",
    "capabilities": {
      "edit": true
    },
    "events": [
      {
        "id": "cmusrceel0000q7kaafxqi1om",
        "kind": "string",
        "actor": "string",
        "actor_name": "string",
        "body": "string",
        "created_at": "2026-10-06T05:30:00.000Z"
      }
    ],
    "media": [
      {
        "id": "cmusrceel0000q7kaafxqi1om",
        "source": "string",
        "role": "issue",
        "kind": "photo",
        "status": "processing",
        "content_type": "string",
        "failure": "string",
        "preview_url": "string",
        "thumb_url": "string",
        "created_at": "2026-10-06T05:30:00.000Z"
      }
    ],
    "links": [
      {
        "id": "cmusrceel0000q7kaafxqi1om",
        "party": "tenant",
        "status": "string",
        "expires_at": "2026-10-06T05:30:00.000Z",
        "used_at": "2026-10-06T05:30:00.000Z",
        "decision": "string",
        "blocked_reason": "string"
      }
    ],
    "vendor_phone": "string"
  },
  "meta": {}
}

Errors

401 No valid session or API key (missing, expired or revoked).
403 The caller lacks the permission, API-key scope or support grant this operation needs.
404 Not found — records of another company are reported the same way.
422 Invalid input; `error.fields` maps field paths to messages.
429 Too many requests; retry after the Retry-After header.
500 Unexpected error; quote `error.request_id` to support.

POST/v1/maintenance-tickets/{id}/approval

Record the owner’s decision

The owner decided by phone: approve, reject or a question. The open approval link is withdrawn; audited. Also needs deals.approve (403).

Access: Signed-in members only (web or Android session) — not for API keys. Permission rentals.edit.

Parameters

idpathrequired: Id
Opaque record id.

Request body

decisionrequired: "approve" | "reject" | "ask"
note: string or null

Response · 200

datarequired: MaintenanceTicket
metarequired: object

Request

curl -X POST 'https://api.propzolo.com/v1/maintenance-tickets/{id}/approval' \
  -H 'Authorization: Bearer pz_live_…' \
  -H 'Content-Type: application/json' \
  -d '{"decision":"approve","note":"string"}'

Response example

{
  "data": {
    "id": "cmusrceel0000q7kaafxqi1om",
    "number": 0,
    "ref": "string",
    "agreement_id": "cmusrceel0000q7kaafxqi1om",
    "property": {
      "id": "cmusrceel0000q7kaafxqi1om",
      "title": "string"
    },
    "tenant": {
      "id": "cmusrceel0000q7kaafxqi1om",
      "name": "string"
    },
    "source": "whatsapp",
    "title": "string",
    "description": "string",
    "category": "string",
    "urgency": "emergency",
    "status": "new",
    "triage": {
      "category": "string",
      "urgency": "string",
      "vendor_trade": "string",
      "summary": "string",
      "clarifying_question": "string",
      "confidence": 0,
      "flags": [
        "string"
      ],
      "model": "string",
      "at": "string"
    },
    "triage_confirmed": true,
    "vendor": {
      "id": "cmusrceel0000q7kaafxqi1om",
      "name": "string"
    },
    "vendor_trade": "string",
    "scheduled_for": "2026-10-06T05:30:00.000Z",
    "resolved_at": "2026-10-06T05:30:00.000Z",
    "closed_at": "2026-10-06T05:30:00.000Z",
    "closed_via": "string",
    "reopened_count": 0,
    "sla": {
      "respond_due_at": "2026-10-06T05:30:00.000Z",
      "resolve_due_at": "2026-10-06T05:30:00.000Z",
      "state": "met"
    },
    "cost_estimate": 850000000,
    "estimate_note": "string",
    "final_cost": 850000000,
    "payer": "owner",
    "approval": {
      "status": "none",
      "threshold": 850000000,
      "approved_estimate": 850000000,
      "decided_at": "2026-10-06T05:30:00.000Z",
      "note": "string"
    },
    "deposit_charge_status": "none",
    "resolution_note": "string",
    "cancel_reason": "string",
    "assignee_id": "cmusrceel0000q7kaafxqi1om",
    "created_at": "2026-10-06T05:30:00.000Z",
    "updated_at": "2026-10-06T05:30:00.000Z",
    "capabilities": {
      "edit": true
    }
  },
  "meta": {}
}

Errors

401 No valid session or API key (missing, expired or revoked).
403 The caller lacks the permission, API-key scope or support grant this operation needs.
404 Not found — records of another company are reported the same way.
409 A unique value already exists, a concurrent change won, or the Idempotency-Key is still in use or was sent with a different request.
422 Invalid input; `error.fields` maps field paths to messages.
429 Too many requests; retry after the Retry-After header.
500 Unexpected error; quote `error.request_id` to support.

POST/v1/maintenance-tickets/{id}/assign

Assign a vendor

A vendor takes the ticket. With `dispatch` (default) the vendor gets the job on WhatsApp / SMS with their update link, through the compliance-gated pipeline; the tenant is told.

Access: Signed-in members only (web or Android session) — not for API keys. Permission rentals.edit.

Parameters

idpathrequired: Id
Opaque record id.

Request body

vendor_idrequired: Id
Opaque record id.
dispatch: boolean
note: string or null

Response · 200

datarequired: object
data.ticketrequired: MaintenanceTicket
data.dispatchrequired: object
data.dispatch.statusrequired: "queued" | "blocked" | "skipped"
data.dispatch.reasonrequired: string or null
metarequired: object

Request

curl -X POST 'https://api.propzolo.com/v1/maintenance-tickets/{id}/assign' \
  -H 'Authorization: Bearer pz_live_…' \
  -H 'Content-Type: application/json' \
  -d '{"vendor_id":"cmusrceel0000q7kaafxqi1om","dispatch":true,"note":"string"}'

Response example

{
  "data": {
    "ticket": {
      "id": "cmusrceel0000q7kaafxqi1om",
      "number": 0,
      "ref": "string",
      "agreement_id": "cmusrceel0000q7kaafxqi1om",
      "property": {
        "id": "cmusrceel0000q7kaafxqi1om",
        "title": "string"
      },
      "tenant": {
        "id": "cmusrceel0000q7kaafxqi1om",
        "name": "string"
      },
      "source": "whatsapp",
      "title": "string",
      "description": "string",
      "category": "string",
      "urgency": "emergency",
      "status": "new",
      "triage": {
        "category": "string",
        "urgency": "string",
        "vendor_trade": "string",
        "summary": "string",
        "clarifying_question": "string",
        "confidence": 0,
        "flags": [
          "string"
        ],
        "model": "string",
        "at": "string"
      },
      "triage_confirmed": true,
      "vendor": {
        "id": "cmusrceel0000q7kaafxqi1om",
        "name": "string"
      },
      "vendor_trade": "string",
      "scheduled_for": "2026-10-06T05:30:00.000Z",
      "resolved_at": "2026-10-06T05:30:00.000Z",
      "closed_at": "2026-10-06T05:30:00.000Z",
      "closed_via": "string",
      "reopened_count": 0,
      "sla": {
        "respond_due_at": "2026-10-06T05:30:00.000Z",
        "resolve_due_at": "2026-10-06T05:30:00.000Z",
        "state": "met"
      },
      "cost_estimate": 850000000,
      "estimate_note": "string",
      "final_cost": 850000000,
      "payer": "owner",
      "approval": {
        "status": "none",
        "threshold": 850000000,
        "approved_estimate": 850000000,
        "decided_at": "2026-10-06T05:30:00.000Z",
        "note": "string"
      },
      "deposit_charge_status": "none",
      "resolution_note": "string",
      "cancel_reason": "string",
      "assignee_id": "cmusrceel0000q7kaafxqi1om",
      "created_at": "2026-10-06T05:30:00.000Z",
      "updated_at": "2026-10-06T05:30:00.000Z",
      "capabilities": {
        "edit": true
      }
    },
    "dispatch": {
      "status": "queued",
      "reason": "string"
    }
  },
  "meta": {}
}

Errors

401 No valid session or API key (missing, expired or revoked).
403 The caller lacks the permission, API-key scope or support grant this operation needs.
404 Not found — records of another company are reported the same way.
409 A unique value already exists, a concurrent change won, or the Idempotency-Key is still in use or was sent with a different request.
422 Invalid input; `error.fields` maps field paths to messages.
429 Too many requests; retry after the Retry-After header.
500 Unexpected error; quote `error.request_id` to support.

POST/v1/maintenance-tickets/{id}/estimate

Record the estimate and who pays

Above the owner’s threshold (owner or deposit pays) the estimate goes to the owner for approval on a single-use link; at or below it the work proceeds. A higher estimate after an approval asks again.

Access: Signed-in members only (web or Android session) — not for API keys. Permission rentals.edit.

Parameters

idpathrequired: Id
Opaque record id.

Request body

amountrequired: PaiseInput
Money in paise (₹1 = 100): an integer, or a digit string for huge amounts.
payerrequired: "owner" | "tenant" | "deposit" | "company"
note: string or null

Response · 200

datarequired: object
data.ticketrequired: MaintenanceTicket
data.approvalrequired: object
data.approval.neededrequired: boolean
data.approval.statusrequired: string
data.approval.reasonrequired: string or null
metarequired: object

Request

curl -X POST 'https://api.propzolo.com/v1/maintenance-tickets/{id}/estimate' \
  -H 'Authorization: Bearer pz_live_…' \
  -H 'Content-Type: application/json' \
  -d '{"amount":0,"payer":"owner","note":"string"}'

Response example

{
  "data": {
    "ticket": {
      "id": "cmusrceel0000q7kaafxqi1om",
      "number": 0,
      "ref": "string",
      "agreement_id": "cmusrceel0000q7kaafxqi1om",
      "property": {
        "id": "cmusrceel0000q7kaafxqi1om",
        "title": "string"
      },
      "tenant": {
        "id": "cmusrceel0000q7kaafxqi1om",
        "name": "string"
      },
      "source": "whatsapp",
      "title": "string",
      "description": "string",
      "category": "string",
      "urgency": "emergency",
      "status": "new",
      "triage": {
        "category": "string",
        "urgency": "string",
        "vendor_trade": "string",
        "summary": "string",
        "clarifying_question": "string",
        "confidence": 0,
        "flags": [
          "string"
        ],
        "model": "string",
        "at": "string"
      },
      "triage_confirmed": true,
      "vendor": {
        "id": "cmusrceel0000q7kaafxqi1om",
        "name": "string"
      },
      "vendor_trade": "string",
      "scheduled_for": "2026-10-06T05:30:00.000Z",
      "resolved_at": "2026-10-06T05:30:00.000Z",
      "closed_at": "2026-10-06T05:30:00.000Z",
      "closed_via": "string",
      "reopened_count": 0,
      "sla": {
        "respond_due_at": "2026-10-06T05:30:00.000Z",
        "resolve_due_at": "2026-10-06T05:30:00.000Z",
        "state": "met"
      },
      "cost_estimate": 850000000,
      "estimate_note": "string",
      "final_cost": 850000000,
      "payer": "owner",
      "approval": {
        "status": "none",
        "threshold": 850000000,
        "approved_estimate": 850000000,
        "decided_at": "2026-10-06T05:30:00.000Z",
        "note": "string"
      },
      "deposit_charge_status": "none",
      "resolution_note": "string",
      "cancel_reason": "string",
      "assignee_id": "cmusrceel0000q7kaafxqi1om",
      "created_at": "2026-10-06T05:30:00.000Z",
      "updated_at": "2026-10-06T05:30:00.000Z",
      "capabilities": {
        "edit": true
      }
    },
    "approval": {
      "needed": true,
      "status": "string",
      "reason": "string"
    }
  },
  "meta": {}
}

Errors

401 No valid session or API key (missing, expired or revoked).
403 The caller lacks the permission, API-key scope or support grant this operation needs.
404 Not found — records of another company are reported the same way.
409 A unique value already exists, a concurrent change won, or the Idempotency-Key is still in use or was sent with a different request.
422 Invalid input; `error.fields` maps field paths to messages.
429 Too many requests; retry after the Retry-After header.
500 Unexpected error; quote `error.request_id` to support.

POST/v1/maintenance-tickets/{id}/media

Register an uploaded file

Adds the uploaded file to the ticket; the worker writes its EXIF/GPS-free copies (documents are scanned).

Access: Signed-in members only (web or Android session) — not for API keys. Permission rentals.edit.

Parameters

idpathrequired: Id
Opaque record id.

Request body

keyrequired: string
content_typerequired: string
sizerequired: integer
role: "issue" | "work_done" | "invoice"

Response · 201

datarequired: object
data.idrequired: Id
Opaque record id.
metarequired: object

Request

curl -X POST 'https://api.propzolo.com/v1/maintenance-tickets/{id}/media' \
  -H 'Authorization: Bearer pz_live_…' \
  -H 'Content-Type: application/json' \
  -d '{"key":"string","content_type":"string","size":1,"role":"issue"}'

Response example

{
  "data": {
    "id": "cmusrceel0000q7kaafxqi1om"
  },
  "meta": {}
}

Errors

401 No valid session or API key (missing, expired or revoked).
403 The caller lacks the permission, API-key scope or support grant this operation needs.
404 Not found — records of another company are reported the same way.
409 A unique value already exists, a concurrent change won, or the Idempotency-Key is still in use or was sent with a different request.
422 Invalid input; `error.fields` maps field paths to messages.
429 Too many requests; retry after the Retry-After header.
500 Unexpected error; quote `error.request_id` to support.

POST/v1/maintenance-tickets/{id}/media/uploads

Upload a photo, video or invoice

A presigned PUT into private storage (type and exact size signed). Register the file afterwards.

Access: Signed-in members only (web or Android session) — not for API keys. Permission rentals.edit.

Parameters

idpathrequired: Id
Opaque record id.

Request body

content_typerequired: string
sizerequired: integer
filename: string or null

Response · 200

datarequired: object
data.keyrequired: string
data.urlrequired: string
data.methodrequired: "PUT"
data.headersrequired: map of string
data.expires_atrequired: DateTime
Instant in ISO 8601, e.g. 2026-10-03T04:30:00.000Z.
metarequired: object

Request

curl -X POST 'https://api.propzolo.com/v1/maintenance-tickets/{id}/media/uploads' \
  -H 'Authorization: Bearer pz_live_…' \
  -H 'Content-Type: application/json' \
  -d '{"content_type":"string","size":1,"filename":"string"}'

Response example

{
  "data": {
    "key": "string",
    "url": "string",
    "method": "PUT",
    "headers": {},
    "expires_at": "2026-10-06T05:30:00.000Z"
  },
  "meta": {}
}

Errors

401 No valid session or API key (missing, expired or revoked).
403 The caller lacks the permission, API-key scope or support grant this operation needs.
404 Not found — records of another company are reported the same way.
409 A unique value already exists, a concurrent change won, or the Idempotency-Key is still in use or was sent with a different request.
422 Invalid input; `error.fields` maps field paths to messages.
429 Too many requests; retry after the Retry-After header.
500 Unexpected error; quote `error.request_id` to support.

POST/v1/maintenance-tickets/{id}/notes

Add a note to the timeline

An internal note on the ticket’s timeline (never sent to the tenant, vendor or owner).

Access: Signed-in members only (web or Android session) — not for API keys. Permission rentals.edit.

Parameters

idpathrequired: Id
Opaque record id.

Request body

bodyrequired: string

Response · 201

datarequired: object
data.okrequired: true
metarequired: object

Request

curl -X POST 'https://api.propzolo.com/v1/maintenance-tickets/{id}/notes' \
  -H 'Authorization: Bearer pz_live_…' \
  -H 'Content-Type: application/json' \
  -d '{"body":"string"}'

Response example

{
  "data": {
    "ok": true
  },
  "meta": {}
}

Errors

401 No valid session or API key (missing, expired or revoked).
403 The caller lacks the permission, API-key scope or support grant this operation needs.
404 Not found — records of another company are reported the same way.
409 A unique value already exists, a concurrent change won, or the Idempotency-Key is still in use or was sent with a different request.
422 Invalid input; `error.fields` maps field paths to messages.
429 Too many requests; retry after the Retry-After header.
500 Unexpected error; quote `error.request_id` to support.

POST/v1/maintenance-tickets/{id}/status

Move a ticket

Schedule the visit, start the work, resolve (the tenant is asked to confirm), close, reopen (within the window) or cancel. Work cannot start while the owner’s approval is pending or was refused (409). A final cost above what the owner approved (or the threshold) for owner- or deposit-paid work is refused (409): save it as the estimate first. Resolving a resolved ticket with a final cost confirms the cost (a vendor’s figure is only a quote).

Access: Signed-in members only (web or Android session) — not for API keys. Permission rentals.edit.

Parameters

idpathrequired: Id
Opaque record id.

Request body

No fields.

Response · 200

datarequired: MaintenanceTicket
metarequired: object

Request

curl -X POST 'https://api.propzolo.com/v1/maintenance-tickets/{id}/status' \
  -H 'Authorization: Bearer pz_live_…' \
  -H 'Content-Type: application/json' \
  -d '{"to":"scheduled","scheduled_for":"2026-10-06T05:30:00.000Z","note":"string"}'

Response example

{
  "data": {
    "id": "cmusrceel0000q7kaafxqi1om",
    "number": 0,
    "ref": "string",
    "agreement_id": "cmusrceel0000q7kaafxqi1om",
    "property": {
      "id": "cmusrceel0000q7kaafxqi1om",
      "title": "string"
    },
    "tenant": {
      "id": "cmusrceel0000q7kaafxqi1om",
      "name": "string"
    },
    "source": "whatsapp",
    "title": "string",
    "description": "string",
    "category": "string",
    "urgency": "emergency",
    "status": "new",
    "triage": {
      "category": "string",
      "urgency": "string",
      "vendor_trade": "string",
      "summary": "string",
      "clarifying_question": "string",
      "confidence": 0,
      "flags": [
        "string"
      ],
      "model": "string",
      "at": "string"
    },
    "triage_confirmed": true,
    "vendor": {
      "id": "cmusrceel0000q7kaafxqi1om",
      "name": "string"
    },
    "vendor_trade": "string",
    "scheduled_for": "2026-10-06T05:30:00.000Z",
    "resolved_at": "2026-10-06T05:30:00.000Z",
    "closed_at": "2026-10-06T05:30:00.000Z",
    "closed_via": "string",
    "reopened_count": 0,
    "sla": {
      "respond_due_at": "2026-10-06T05:30:00.000Z",
      "resolve_due_at": "2026-10-06T05:30:00.000Z",
      "state": "met"
    },
    "cost_estimate": 850000000,
    "estimate_note": "string",
    "final_cost": 850000000,
    "payer": "owner",
    "approval": {
      "status": "none",
      "threshold": 850000000,
      "approved_estimate": 850000000,
      "decided_at": "2026-10-06T05:30:00.000Z",
      "note": "string"
    },
    "deposit_charge_status": "none",
    "resolution_note": "string",
    "cancel_reason": "string",
    "assignee_id": "cmusrceel0000q7kaafxqi1om",
    "created_at": "2026-10-06T05:30:00.000Z",
    "updated_at": "2026-10-06T05:30:00.000Z",
    "capabilities": {
      "edit": true
    }
  },
  "meta": {}
}

Errors

401 No valid session or API key (missing, expired or revoked).
403 The caller lacks the permission, API-key scope or support grant this operation needs.
404 Not found — records of another company are reported the same way.
409 A unique value already exists, a concurrent change won, or the Idempotency-Key is still in use or was sent with a different request.
422 Invalid input; `error.fields` maps field paths to messages.
429 Too many requests; retry after the Retry-After header.
500 Unexpected error; quote `error.request_id` to support.

POST/v1/maintenance-tickets/{id}/triage

Confirm or correct the triage

Sets category, urgency and trade (a new urgency recomputes the SLA deadlines). A new ticket becomes triaged.

Access: Signed-in members only (web or Android session) — not for API keys. Permission rentals.edit.

Parameters

idpathrequired: Id
Opaque record id.

Request body

categoryrequired: "plumbing" | "electrical" | "appliance" | "carpentry" | "pest" | "painting" | …
urgencyrequired: "emergency" | "high" | "normal" | "low"
vendor_trade: "plumber" | "electrician" | "appliance_repair" | "carpenter" | "pest_control" | "painter" | … or null
title: string or null

Response · 200

datarequired: MaintenanceTicket
metarequired: object

Request

curl -X POST 'https://api.propzolo.com/v1/maintenance-tickets/{id}/triage' \
  -H 'Authorization: Bearer pz_live_…' \
  -H 'Content-Type: application/json' \
  -d '{"category":"plumbing","urgency":"emergency","vendor_trade":"plumber","title":"string"}'

Response example

{
  "data": {
    "id": "cmusrceel0000q7kaafxqi1om",
    "number": 0,
    "ref": "string",
    "agreement_id": "cmusrceel0000q7kaafxqi1om",
    "property": {
      "id": "cmusrceel0000q7kaafxqi1om",
      "title": "string"
    },
    "tenant": {
      "id": "cmusrceel0000q7kaafxqi1om",
      "name": "string"
    },
    "source": "whatsapp",
    "title": "string",
    "description": "string",
    "category": "string",
    "urgency": "emergency",
    "status": "new",
    "triage": {
      "category": "string",
      "urgency": "string",
      "vendor_trade": "string",
      "summary": "string",
      "clarifying_question": "string",
      "confidence": 0,
      "flags": [
        "string"
      ],
      "model": "string",
      "at": "string"
    },
    "triage_confirmed": true,
    "vendor": {
      "id": "cmusrceel0000q7kaafxqi1om",
      "name": "string"
    },
    "vendor_trade": "string",
    "scheduled_for": "2026-10-06T05:30:00.000Z",
    "resolved_at": "2026-10-06T05:30:00.000Z",
    "closed_at": "2026-10-06T05:30:00.000Z",
    "closed_via": "string",
    "reopened_count": 0,
    "sla": {
      "respond_due_at": "2026-10-06T05:30:00.000Z",
      "resolve_due_at": "2026-10-06T05:30:00.000Z",
      "state": "met"
    },
    "cost_estimate": 850000000,
    "estimate_note": "string",
    "final_cost": 850000000,
    "payer": "owner",
    "approval": {
      "status": "none",
      "threshold": 850000000,
      "approved_estimate": 850000000,
      "decided_at": "2026-10-06T05:30:00.000Z",
      "note": "string"
    },
    "deposit_charge_status": "none",
    "resolution_note": "string",
    "cancel_reason": "string",
    "assignee_id": "cmusrceel0000q7kaafxqi1om",
    "created_at": "2026-10-06T05:30:00.000Z",
    "updated_at": "2026-10-06T05:30:00.000Z",
    "capabilities": {
      "edit": true
    }
  },
  "meta": {}
}

Errors

401 No valid session or API key (missing, expired or revoked).
403 The caller lacks the permission, API-key scope or support grant this operation needs.
404 Not found — records of another company are reported the same way.
409 A unique value already exists, a concurrent change won, or the Idempotency-Key is still in use or was sent with a different request.
422 Invalid input; `error.fields` maps field paths to messages.
429 Too many requests; retry after the Retry-After header.
500 Unexpected error; quote `error.request_id` to support.

GET/v1/maintenance-vendors

The vendor directory

Active vendors by rating, filterable by trade; archived ones with `status=archived|all`.

Access: Signed-in members only (web or Android session) — not for API keys. Permission rentals.view or settings.pipelines.

Parameters

tradequery: "plumber" | "electrician" | "appliance_repair" | "carpenter" | "pest_control" | "painter" | …
statusquery: "active" | "archived" | "all"
qquery: string

Response · 200

datarequired: array of MaintenanceVendor
metarequired: object

Request

curl -X GET 'https://api.propzolo.com/v1/maintenance-vendors' \
  -H 'Authorization: Bearer pz_live_…'

Response example

{
  "data": [
    {
      "id": "cmusrceel0000q7kaafxqi1om",
      "name": "string",
      "trades": [
        "string"
      ],
      "areas": [
        "string"
      ],
      "phone_e164": "string",
      "contact_id": "cmusrceel0000q7kaafxqi1om",
      "rates_note": "string",
      "notes": "string",
      "rating": 0,
      "status": "active",
      "created_at": "2026-10-06T05:30:00.000Z",
      "updated_at": "2026-10-06T05:30:00.000Z"
    }
  ],
  "meta": {}
}

Errors

401 No valid session or API key (missing, expired or revoked).
403 The caller lacks the permission, API-key scope or support grant this operation needs.
422 Invalid input; `error.fields` maps field paths to messages.
429 Too many requests; retry after the Retry-After header.
500 Unexpected error; quote `error.request_id` to support.

POST/v1/maintenance-vendors

Add a vendor

The phone is normalised (one vendor per number); the vendor is messaged through that number’s contact.

Access: Signed-in members only (web or Android session) — not for API keys. Permission settings.pipelines.

Request body

namerequired: string
phonerequired: string
tradesrequired: array of "plumber" | "electrician" | "appliance_repair" | "carpenter" | "pest_control" | "painter" | …
areas: array of string
rates_note: string or null
notes: string or null
rating: integer or null

Response · 201

datarequired: MaintenanceVendor
metarequired: object

Request

curl -X POST 'https://api.propzolo.com/v1/maintenance-vendors' \
  -H 'Authorization: Bearer pz_live_…' \
  -H 'Content-Type: application/json' \
  -d '{"name":"string","phone":"string","trades":["plumber"],"areas":[],"rates_note":"string","notes":"string","rating":1}'

Response example

{
  "data": {
    "id": "cmusrceel0000q7kaafxqi1om",
    "name": "string",
    "trades": [
      "string"
    ],
    "areas": [
      "string"
    ],
    "phone_e164": "string",
    "contact_id": "cmusrceel0000q7kaafxqi1om",
    "rates_note": "string",
    "notes": "string",
    "rating": 0,
    "status": "active",
    "created_at": "2026-10-06T05:30:00.000Z",
    "updated_at": "2026-10-06T05:30:00.000Z"
  },
  "meta": {}
}

Errors

401 No valid session or API key (missing, expired or revoked).
403 The caller lacks the permission, API-key scope or support grant this operation needs.
409 A unique value already exists, a concurrent change won, or the Idempotency-Key is still in use or was sent with a different request.
422 Invalid input; `error.fields` maps field paths to messages.
429 Too many requests; retry after the Retry-After header.
500 Unexpected error; quote `error.request_id` to support.

PUT/v1/maintenance-vendors/{id}

Edit a vendor

Name, phone, trades, areas, rates note, notes and rating.

Access: Signed-in members only (web or Android session) — not for API keys. Permission settings.pipelines.

Parameters

idpathrequired: Id
Opaque record id.

Request body

namerequired: string
phonerequired: string
tradesrequired: array of "plumber" | "electrician" | "appliance_repair" | "carpenter" | "pest_control" | "painter" | …
areas: array of string
rates_note: string or null
notes: string or null
rating: integer or null

Response · 200

datarequired: MaintenanceVendor
metarequired: object

Request

curl -X PUT 'https://api.propzolo.com/v1/maintenance-vendors/{id}' \
  -H 'Authorization: Bearer pz_live_…' \
  -H 'Content-Type: application/json' \
  -d '{"name":"string","phone":"string","trades":["plumber"],"areas":[],"rates_note":"string","notes":"string","rating":1}'

Response example

{
  "data": {
    "id": "cmusrceel0000q7kaafxqi1om",
    "name": "string",
    "trades": [
      "string"
    ],
    "areas": [
      "string"
    ],
    "phone_e164": "string",
    "contact_id": "cmusrceel0000q7kaafxqi1om",
    "rates_note": "string",
    "notes": "string",
    "rating": 0,
    "status": "active",
    "created_at": "2026-10-06T05:30:00.000Z",
    "updated_at": "2026-10-06T05:30:00.000Z"
  },
  "meta": {}
}

Errors

401 No valid session or API key (missing, expired or revoked).
403 The caller lacks the permission, API-key scope or support grant this operation needs.
404 Not found — records of another company are reported the same way.
409 A unique value already exists, a concurrent change won, or the Idempotency-Key is still in use or was sent with a different request.
422 Invalid input; `error.fields` maps field paths to messages.
429 Too many requests; retry after the Retry-After header.
500 Unexpected error; quote `error.request_id` to support.

POST/v1/maintenance-vendors/{id}/status

Archive or restore a vendor

An archived vendor cannot be assigned; their tickets keep them.

Access: Signed-in members only (web or Android session) — not for API keys. Permission settings.pipelines.

Parameters

idpathrequired: Id
Opaque record id.

Request body

statusrequired: "active" | "archived"

Response · 200

datarequired: MaintenanceVendor
metarequired: object

Request

curl -X POST 'https://api.propzolo.com/v1/maintenance-vendors/{id}/status' \
  -H 'Authorization: Bearer pz_live_…' \
  -H 'Content-Type: application/json' \
  -d '{"status":"active"}'

Response example

{
  "data": {
    "id": "cmusrceel0000q7kaafxqi1om",
    "name": "string",
    "trades": [
      "string"
    ],
    "areas": [
      "string"
    ],
    "phone_e164": "string",
    "contact_id": "cmusrceel0000q7kaafxqi1om",
    "rates_note": "string",
    "notes": "string",
    "rating": 0,
    "status": "active",
    "created_at": "2026-10-06T05:30:00.000Z",
    "updated_at": "2026-10-06T05:30:00.000Z"
  },
  "meta": {}
}

Errors

401 No valid session or API key (missing, expired or revoked).
403 The caller lacks the permission, API-key scope or support grant this operation needs.
404 Not found — records of another company are reported the same way.
409 A unique value already exists, a concurrent change won, or the Idempotency-Key is still in use or was sent with a different request.
422 Invalid input; `error.fields` maps field paths to messages.
429 Too many requests; retry after the Retry-After header.
500 Unexpected error; quote `error.request_id` to support.

GET/v1/rental-agreements/{id}/maintenance

An agreement’s maintenance

The agreement drawer’s section: its tickets, the owner-approval threshold and the tenant’s request link.

Access: Signed-in members only (web or Android session) — not for API keys. Permission rentals.view.

Parameters

idpathrequired: Id
Opaque record id.

Response · 200

datarequired: AgreementMaintenance
metarequired: object

Request

curl -X GET 'https://api.propzolo.com/v1/rental-agreements/{id}/maintenance' \
  -H 'Authorization: Bearer pz_live_…'

Response example

{
  "data": {
    "agreement_id": "cmusrceel0000q7kaafxqi1om",
    "threshold": 850000000,
    "default_threshold": 850000000,
    "tenant_link": {
      "id": "cmusrceel0000q7kaafxqi1om",
      "status": "string",
      "expires_at": "2026-10-06T05:30:00.000Z"
    },
    "tickets": [
      {
        "id": "cmusrceel0000q7kaafxqi1om",
        "number": 0,
        "ref": "string",
        "agreement_id": "cmusrceel0000q7kaafxqi1om",
        "property": {
          "id": "cmusrceel0000q7kaafxqi1om",
          "title": "string"
        },
        "tenant": {
          "id": "cmusrceel0000q7kaafxqi1om",
          "name": "string"
        },
        "source": "whatsapp",
        "title": "string",
        "description": "string",
        "category": "string",
        "urgency": "emergency",
        "status": "new",
        "triage": {
          "category": "string",
          "urgency": "string",
          "vendor_trade": "string",
          "summary": "string",
          "clarifying_question": "string",
          "confidence": 0,
          "flags": [
            "string"
          ],
          "model": "string",
          "at": "string"
        },
        "triage_confirmed": true,
        "vendor": {
          "id": "cmusrceel0000q7kaafxqi1om",
          "name": "string"
        },
        "vendor_trade": "string",
        "scheduled_for": "2026-10-06T05:30:00.000Z",
        "resolved_at": "2026-10-06T05:30:00.000Z",
        "closed_at": "2026-10-06T05:30:00.000Z",
        "closed_via": "string",
        "reopened_count": 0,
        "sla": {
          "respond_due_at": "2026-10-06T05:30:00.000Z",
          "resolve_due_at": "2026-10-06T05:30:00.000Z",
          "state": "met"
        },
        "cost_estimate": 850000000,
        "estimate_note": "string",
        "final_cost": 850000000,
        "payer": "owner",
        "approval": {
          "status": "none",
          "threshold": 850000000,
          "approved_estimate": 850000000,
          "decided_at": "2026-10-06T05:30:00.000Z",
          "note": "string"
        },
        "deposit_charge_status": "none",
        "resolution_note": "string",
        "cancel_reason": "string",
        "assignee_id": "cmusrceel0000q7kaafxqi1om",
        "created_at": "2026-10-06T05:30:00.000Z",
        "updated_at": "2026-10-06T05:30:00.000Z",
        "capabilities": {
          "edit": true
        }
      }
    ]
  },
  "meta": {}
}

Errors

401 No valid session or API key (missing, expired or revoked).
403 The caller lacks the permission, API-key scope or support grant this operation needs.
404 Not found — records of another company are reported the same way.
422 Invalid input; `error.fields` maps field paths to messages.
429 Too many requests; retry after the Retry-After header.
500 Unexpected error; quote `error.request_id` to support.

PUT/v1/rental-agreements/{id}/maintenance

Set the owner-approval threshold

Repairs the owner pays above this amount need the owner’s approval; null uses the company default. Also needs deals.approve (403).

Access: Signed-in members only (web or Android session) — not for API keys. Permission rentals.edit.

Parameters

idpathrequired: Id
Opaque record id.

Request body

thresholdrequired: PaiseInput or null
Money in paise (₹1 = 100): an integer, or a digit string for huge amounts.

Response · 200

datarequired: AgreementMaintenance
metarequired: object

Request

curl -X PUT 'https://api.propzolo.com/v1/rental-agreements/{id}/maintenance' \
  -H 'Authorization: Bearer pz_live_…' \
  -H 'Content-Type: application/json' \
  -d '{"threshold":0}'

Response example

{
  "data": {
    "agreement_id": "cmusrceel0000q7kaafxqi1om",
    "threshold": 850000000,
    "default_threshold": 850000000,
    "tenant_link": {
      "id": "cmusrceel0000q7kaafxqi1om",
      "status": "string",
      "expires_at": "2026-10-06T05:30:00.000Z"
    },
    "tickets": [
      {
        "id": "cmusrceel0000q7kaafxqi1om",
        "number": 0,
        "ref": "string",
        "agreement_id": "cmusrceel0000q7kaafxqi1om",
        "property": {
          "id": "cmusrceel0000q7kaafxqi1om",
          "title": "string"
        },
        "tenant": {
          "id": "cmusrceel0000q7kaafxqi1om",
          "name": "string"
        },
        "source": "whatsapp",
        "title": "string",
        "description": "string",
        "category": "string",
        "urgency": "emergency",
        "status": "new",
        "triage": {
          "category": "string",
          "urgency": "string",
          "vendor_trade": "string",
          "summary": "string",
          "clarifying_question": "string",
          "confidence": 0,
          "flags": [
            "string"
          ],
          "model": "string",
          "at": "string"
        },
        "triage_confirmed": true,
        "vendor": {
          "id": "cmusrceel0000q7kaafxqi1om",
          "name": "string"
        },
        "vendor_trade": "string",
        "scheduled_for": "2026-10-06T05:30:00.000Z",
        "resolved_at": "2026-10-06T05:30:00.000Z",
        "closed_at": "2026-10-06T05:30:00.000Z",
        "closed_via": "string",
        "reopened_count": 0,
        "sla": {
          "respond_due_at": "2026-10-06T05:30:00.000Z",
          "resolve_due_at": "2026-10-06T05:30:00.000Z",
          "state": "met"
        },
        "cost_estimate": 850000000,
        "estimate_note": "string",
        "final_cost": 850000000,
        "payer": "owner",
        "approval": {
          "status": "none",
          "threshold": 850000000,
          "approved_estimate": 850000000,
          "decided_at": "2026-10-06T05:30:00.000Z",
          "note": "string"
        },
        "deposit_charge_status": "none",
        "resolution_note": "string",
        "cancel_reason": "string",
        "assignee_id": "cmusrceel0000q7kaafxqi1om",
        "created_at": "2026-10-06T05:30:00.000Z",
        "updated_at": "2026-10-06T05:30:00.000Z",
        "capabilities": {
          "edit": true
        }
      }
    ]
  },
  "meta": {}
}

Errors

401 No valid session or API key (missing, expired or revoked).
403 The caller lacks the permission, API-key scope or support grant this operation needs.
404 Not found — records of another company are reported the same way.
409 A unique value already exists, a concurrent change won, or the Idempotency-Key is still in use or was sent with a different request.
422 Invalid input; `error.fields` maps field paths to messages.
429 Too many requests; retry after the Retry-After header.
500 Unexpected error; quote `error.request_id` to support.

POST/v1/rental-agreements/{id}/maintenance/tenant-link

Send the tenant their repair request link

A sign-in-free link to report repairs with photos (reusable until it expires; an earlier one stops working).

Access: Signed-in members only (web or Android session) — not for API keys. Permission rentals.edit.

Parameters

idpathrequired: Id
Opaque record id.

Response · 200

datarequired: object
data.statusrequired: "queued" | "blocked"
data.reasonrequired: string or null
metarequired: object

Request

curl -X POST 'https://api.propzolo.com/v1/rental-agreements/{id}/maintenance/tenant-link' \
  -H 'Authorization: Bearer pz_live_…'

Response example

{
  "data": {
    "status": "queued",
    "reason": "string"
  },
  "meta": {}
}

Errors

401 No valid session or API key (missing, expired or revoked).
403 The caller lacks the permission, API-key scope or support grant this operation needs.
404 Not found — records of another company are reported the same way.
422 Invalid input; `error.fields` maps field paths to messages.
429 Too many requests; retry after the Retry-After header.
500 Unexpected error; quote `error.request_id` to support.

GET/v1/settings/rental-maintenance

Maintenance settings

Categories, SLA hours per urgency, the default owner-approval threshold, auto-close, reopen and the intake.

Access: Signed-in members only (web or Android session) — not for API keys. Permission settings.pipelines or settings.view or rentals.view.

Response · 200

datarequired: MaintenanceSettings
metarequired: object

Request

curl -X GET 'https://api.propzolo.com/v1/settings/rental-maintenance' \
  -H 'Authorization: Bearer pz_live_…'

Response example

{
  "data": {
    "categories": [
      "plumbing"
    ],
    "sla": {
      "emergency": {
        "respond_hours": 1,
        "resolve_hours": 1
      },
      "high": {
        "respond_hours": 1,
        "resolve_hours": 1
      },
      "normal": {
        "respond_hours": 1,
        "resolve_hours": 1
      },
      "low": {
        "respond_hours": 1,
        "resolve_hours": 1
      }
    },
    "approval": {
      "default_threshold": 850000000,
      "link_days": 1
    },
    "lifecycle": {
      "auto_close_days": 0,
      "reopen_days": 0
    },
    "intake": {
      "whatsapp": true,
      "ai_triage": true,
      "auto_reply": true,
      "tenant_link_days": 1
    },
    "notify_tenant": true
  },
  "meta": {}
}

Errors

401 No valid session or API key (missing, expired or revoked).
403 The caller lacks the permission, API-key scope or support grant this operation needs.
429 Too many requests; retry after the Retry-After header.
500 Unexpected error; quote `error.request_id` to support.

PUT/v1/settings/rental-maintenance

Save the maintenance settings

Replaces the settings (422 on a bad value, resolving due before responding). Audited.

Access: Signed-in members only (web or Android session) — not for API keys. Permission settings.pipelines.

Request body

categoriesrequired: array of "plumbing" | "electrical" | "appliance" | "carpentry" | "pest" | "painting" | …
slarequired: object
sla.emergencyrequired: object
sla.emergency.respond_hoursrequired: integer
sla.emergency.resolve_hoursrequired: integer
sla.highrequired: object
sla.high.respond_hoursrequired: integer
sla.high.resolve_hoursrequired: integer
sla.normalrequired: object
sla.normal.respond_hoursrequired: integer
sla.normal.resolve_hoursrequired: integer
sla.lowrequired: object
sla.low.respond_hoursrequired: integer
sla.low.resolve_hoursrequired: integer
approvalrequired: object
approval.default_thresholdrequired: Paise
Money in paise (₹1 = 100), an exact integer.
approval.link_daysrequired: integer
lifecyclerequired: object
lifecycle.auto_close_daysrequired: integer
lifecycle.reopen_daysrequired: integer
intakerequired: object
intake.whatsapprequired: boolean
intake.ai_triagerequired: boolean
intake.auto_replyrequired: boolean
intake.tenant_link_daysrequired: integer
notify_tenantrequired: boolean

Response · 200

datarequired: MaintenanceSettings
metarequired: object

Request

curl -X PUT 'https://api.propzolo.com/v1/settings/rental-maintenance' \
  -H 'Authorization: Bearer pz_live_…' \
  -H 'Content-Type: application/json' \
  -d '{"categories":["plumbing"],"sla":{"emergency":{"respond_hours":1,"resolve_hours":1},"high":{"respond_hours":1,"resolve_hours":1},"normal":{"respond_hours":1,"resolve_hours":1},"low":{"respond_hours":1,"resolve_hours":1}},"approval":{"default_threshold":850000000,"link_days":1},"lifecycle":{"auto_close_days":0,"reopen_days":0},"intake":{"whatsapp":true,"ai_triage":true,"auto_reply":true,"tenant_link_days":1},"notify_tenant":true}'

Response example

{
  "data": {
    "categories": [
      "plumbing"
    ],
    "sla": {
      "emergency": {
        "respond_hours": 1,
        "resolve_hours": 1
      },
      "high": {
        "respond_hours": 1,
        "resolve_hours": 1
      },
      "normal": {
        "respond_hours": 1,
        "resolve_hours": 1
      },
      "low": {
        "respond_hours": 1,
        "resolve_hours": 1
      }
    },
    "approval": {
      "default_threshold": 850000000,
      "link_days": 1
    },
    "lifecycle": {
      "auto_close_days": 0,
      "reopen_days": 0
    },
    "intake": {
      "whatsapp": true,
      "ai_triage": true,
      "auto_reply": true,
      "tenant_link_days": 1
    },
    "notify_tenant": true
  },
  "meta": {}
}

Errors

401 No valid session or API key (missing, expired or revoked).
403 The caller lacks the permission, API-key scope or support grant this operation needs.
409 A unique value already exists, a concurrent change won, or the Idempotency-Key is still in use or was sent with a different request.
422 Invalid input; `error.fields` maps field paths to messages.
429 Too many requests; retry after the Retry-After header.
500 Unexpected error; quote `error.request_id` to support.