---
title: "Propose a routine from a document with AI"
method: POST
path: "/customers/{customerId}/buildings/{buildingId}/tasks/routine-proposals/documents/{documentId}"
tags: ["Document Platform"]
---

# Propose a routine from a document with AI

`POST /customers/{customerId}/buildings/{buildingId}/tasks/routine-proposals/documents/{documentId}`

## Request

- Base URL: `http://localhost:9000`
- URL: `http://localhost:9000/customers/{customerId}/buildings/{buildingId}/tasks/routine-proposals/documents/{documentId}`
- Auth: API key in header `x-api-key`

Reads a service report or FDV document and proposes one routine from it: a title, a description and the cadence the document states, as an RRULE without DTSTART. Nothing is created.

## Path parameters

- `customerId` string, uuid, required
- `buildingId` string, uuid, required
- `documentId` string, uuid, required

## Request body

- object
  - `locale` 'en' | 'no' | 'sv' | 'da' | 'fi' | 'fr'
  - `source` 'document' | 'ask'

## Response `200`

Default Response

- object
  - `documentId` string, required
  - `title` string, required
  - `description` string, required
  - `rrule` string, nullable, required
  - `intervalQuote` string, nullable, required

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `409`: Conflict - the resource is busy or in a conflicting state.
- `429`: Too Many Requests - the hourly limit of routine proposals is reached.
- `500`: Internal Server Error
- `503`: Service Unavailable - a downstream dependency is degraded.

## Changes

- **2026-10-15** `ebc00b51310a`: 1 info
  - added the new optional request property `source`
- **2026-10-15** `1841a05ac00d`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/findable/apis/findable-api/changes/customers/:customerId/buildings/:buildingId/tasks/routine-proposals/documents/:documentId/post.md)

---

[API](https://skmtc.dev/findable/apis/findable-api.md) · [All operations](https://skmtc.dev/findable/apis/findable-api/llms.txt) · [OpenAPI document](https://skmtc.dev/findable/apis/findable-api/revisions/e6c9ecac41bb?raw)