canonical: https://jentic.com/apis/letmc.com/letmc-maintenance

# Letmc agentOS API V3, Maintenance Call Group

The agentOS Maintenance Call Group API exposes the maintenance ticket creation flow used by letting agents on the agentOS V3 platform. It lets a connected branch raise a new maintenance job for a property under management, attach the relevant tenancy and contact details, and forward it to the maintenance workflow. The API is scoped narrowly to job creation rather than full ticket lifecycle management.

## For AI agents

Create a new maintenance job for a specific letmc.com agentOS branch so that property maintenance work can be raised against an existing tenancy.

## Scope

Does not handle tenancy creation, rent collection, viewings, or maintenance job closure - use for raising new maintenance jobs into agentOS V3 only.

## Capabilities

- Raise a new maintenance job against a specific agentOS branch using its short name and branch ID
- Attach contact, tenancy, and property context to a maintenance request when it is created
- Authenticate branch-level requests using the ApiKey header issued to letting agents
- Submit maintenance work intake from external systems into the agentOS V3 platform
- Trigger downstream maintenance workflows by handing off job details to the agentOS back office

## Use cases

### Tenant portal maintenance intake

A tenant portal collects maintenance issues from renters and forwards them into the letting agent's agentOS V3 system. Each submission is posted to /v3/maintenance/{shortName}/maintenance/{branchID}/createmaintenancejob with the branch identifier and property details so the agency back office can triage and dispatch the work. This avoids manual rekeying and gets repair requests into the property manager's queue within seconds.

Example prompt: Create a maintenance job at /v3/maintenance/acme/maintenance/123/createmaintenancejob with the tenant name, property reference, and a description of a leaking radiator, then confirm the job was accepted.

### Smart-home device fault dispatch

A smart-home monitoring service detects a boiler or smoke alarm fault and needs to escalate to the managing agent. The agent uses the agentOS Maintenance Call Group API to open a maintenance job under the correct branch with the device context attached, so a contractor can be assigned through the agency's normal workflow.

Example prompt: Post a maintenance job for branch 42 of short name 'rivervalley' describing a boiler pressure fault detected by a connected sensor at flat 3B.

### AI agent maintenance dispatch via Jentic

An AI agent triaging tenant emails identifies a maintenance issue and needs to file it with the managing agency. Through Jentic, the agent searches for 'create a maintenance job', loads the agentOS V3 schema, and executes the call with branch credentials held in your Jentic One instance. The agent never sees the raw ApiKey value, and integration takes minutes rather than days of bespoke work.

Example prompt: Use Jentic to search 'create a maintenance job', load the agentOS V3 maintenance operation, and submit a job for branch 88 with a tenant-reported leak.

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| POST | /v3/maintenance/{shortName}/maintenance/{branchID}/createmaintenancejob | Create a maintenance job for a specific branch. |

## Key resources

- **Maintenance Job** — Single endpoint for creating a maintenance job under a specific agentOS branch.

## Why Jentic

- **Setup:** Wiring the agentOS V3 Maintenance Call Group by hand means handling both its ApiKey header and HTTP Basic credentials, threading the tenant shortName and branchID through the path, and posting jobs against the live-api.letmc.com host yourself. Through Jentic you install once, import the agentOS Maintenance API from the API Directory, store the ApiKey and Basic credentials once, and your agent calls it.
- **Permission scoping:** The createmaintenancejob operation puts the tenant shortName and branchID in the URL path (/v3/maintenance/{shortName}/maintenance/{branchID}/createmaintenancejob), so a rule can pin your agent to one branch: it can raise maintenance jobs there and nothing else. You choose the operations it may call, so it only ever creates the jobs you allow.
- **Credential handling:** Your letmc.com ApiKey and Basic credentials are stored once, encrypted, by your own Jentic One instance and injected at execution time. They never enter the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'raise a maintenance job for a property', and Jentic returns the agentOS V3 createmaintenancejob operation with its input schema so the agent calls the right endpoint without browsing the letmc.com reference docs.

## Related APIs

- **agentOS Diary API** — Companion agentOS V3 API for diary and appointment events from the same letting-agent platform.
- **PandaDoc API** — Document automation API for generating tenancy or works-order paperwork alongside maintenance requests.

## FAQ

### What authentication does the agentOS Maintenance API use?

The API supports two schemes: an ApiKey passed in the 'ApiKey' HTTP header (issued per branch) and Basic HTTP authentication. Through Jentic, these credentials are stored in your Jentic One instance and injected at request time, so the agent never handles the raw ApiKey or basic credentials directly.

### Can I create a maintenance job for any branch with the agentOS Maintenance API?

Yes, but the request must include the branch's short name and branch ID in the URL path (/v3/maintenance/{shortName}/maintenance/{branchID}/createmaintenancejob), and the supplied ApiKey must be authorised for that branch. There is one createmaintenancejob endpoint, so this API only handles job creation, not editing or closing.

### What are the rate limits for the agentOS Maintenance API?

letmc.com does not publish a public rate-limit figure for the Maintenance Call Group endpoint. Treat this as a transactional intake API: batch heavy backfills outside business hours and retry with exponential backoff if you receive 429 or 503 responses.

### How do I submit a maintenance job through Jentic?

Install the SDK with 'pip install jentic', then search for 'create a maintenance job' to discover the createmaintenancejob operation, load its input schema, and execute with the branch's shortName, branchID, and the maintenance details. Jentic injects the ApiKey for the branch automatically.

### Does this API let me update or close maintenance jobs after they are raised?

No. The Maintenance Call Group exposes a single POST createmaintenancejob endpoint. Once a job is created it is handed off to the agentOS back office for triage, dispatch, and closure, which are managed inside agentOS rather than over this API.

### Can I limit what my agent is allowed to do with the agentOS Maintenance API?

Yes. Because you self-host Jentic One, your own rules decide which operations and credentials the agent may use, and this API exposes only the single createmaintenancejob operation. Since the shortName and branchID sit in the request path, you can pin the agent to one branch so it raises maintenance jobs there and calls nothing else. Your stored ApiKey and Basic credentials are injected at execution time only for the calls you permit.