---
title: "Get AI-powered suggestions"
method: POST
path: "/api/v1/ai/suggest"
tags: ["AI"]
---

# Get AI-powered suggestions

`POST /api/v1/ai/suggest`

## Request

- Base URL: `https://api.hiyd.ai`
- URL: `https://api.hiyd.ai/api/v1/ai/suggest`
- Auth: HTTP bearer

Generates AI suggestions based on user's smartwatch data.

## Request body

- AISuggestRequest
  - `userId` string: Optional user identifier
  - `deviceId` string, required: Device identifier
  - `type` string: Type of AI suggestion

## Response `200`

AI suggestion generated successfully

- AISuggestResponse
  - `suggestion` string
  - `confidence` number
  - `type` string

## Other responses

- `400`: Bad request - deviceId is required
- `500`: Internal server error

---

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