---
title: "Interpret a natural-language intent into proposed automations"
method: POST
path: "/app/automations/interpret"
tags: ["App Automation"]
---

# Interpret a natural-language intent into proposed automations

`POST /app/automations/interpret`

## Request

- Base URL: `https://api.optimyzee.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.optimyzee.com/app/automations/interpret`
- Auth: none declared
- TypeScript: <https://skmtc.dev/optimyzee/apis/optimyzee-api/docs/app/automations/interpret/post.ts> (a function with typed inputs; its response is checked against the schema)

## Request body

- object
  - `intent` string, required
  - `context` object, nullable

## Response `200`

OK

- AppAutomationSpecSchema[]
  - `id` string, required
  - `intentText` string, required
  - `title` string, required
  - `summary` string, required
  - `signal` string, required
  - `signalLabel` string, required
  - `trigger` string, required
  - `direction` 'increase' | 'decrease' | 'pause' | 'launch', required
  - `deltaPct` integer, required
  - `target` string, required
  - `scope` string, required
  - `channels` string[], required
  - `guardrails` string, required
  - `requiredConfig` AppAutomationConfigFieldSchema[], required
    - `label` string, required
    - `value` string, required
    - `filledByAi` boolean, required
  - `confidence` string, required

---

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