Skip to main content
POST
Triage a maintenance issue

Authorizations

Authorization
string
header
required

API Key authentication. Use "Bearer YOUR_API_KEY".

Body

application/json
description
string
required

The customer description of the issue to triage.

Required string length: 1 - 2000
issue_category
enum<string>

The category the customer picked, used as a hint.

Available options:
air_conditioning,
appliance,
electricity,
exterior,
heating_system,
housekeeping,
housing,
locksmith,
other,
painting,
pest_control,
plumbing

Response

200 - application/json

Returns a triage object if the request succeeded.

An AI-generated triage of a maintenance issue description.

relevant
boolean
required

Whether the description is about a property maintenance issue at all.

emergency
boolean
required

Whether this reads as an emergency — a gas leak, a fire risk, a flood, no water, or no heating in cold weather. An emergency is never self-resolvable.

name
string
required

A short, specific title for the issue, suitable for a list of work. No trailing period.

issue_category
enum<string>
required

The category the description best fits.

Available options:
air_conditioning,
appliance,
electricity,
exterior,
heating_system,
housekeeping,
housing,
locksmith,
other,
painting,
pest_control,
plumbing
priority
number
required

A suggested priority from 0 to 3, where 0 is low, 1 is medium, 2 is high and 3 is urgent.

suggestions
object[]
required

Safe, practical steps the customer can try themselves, most likely to help first. Empty when nothing can safely be attempted.

object
enum<string>
required
Available options:
maintenance.triage
session
string | null
required

The completion session recording the exchange. Pass it back as triage.portal_completion_session when creating the issue so the team can see what was suggested.