---
title: "List profile suggestions produced from knowledge sources"
method: GET
path: "/api/knowledge/suggestions"
tags: ["Knowledge"]
---

# List profile suggestions produced from knowledge sources

`GET /api/knowledge/suggestions`

## Request

- Base URL: `https://api.setluca.com`
- URL: `https://api.setluca.com/api/knowledge/suggestions`
- Auth: one of:
  - API key in cookie `luca.session_token`
  - API key in header `x-api-key`
  - HTTP bearer

Field-level profile changes pulled out of connected sources, filterable by status. Nothing here has touched the coach profile yet.

**API key scopes:** `knowledge:read`.

## Query parameters

- `status` 'pending' | 'approved' | 'rejected'

## Headers

- `Luca-API-Version` '1'

## Response `200`

ok

- ProfileSuggestionListResponse
  - `suggestions` object[], required
    - `id` string, uuid, required
    - `sourceId` string, uuid, required
    - `fieldPath` string, required
    - `currentValue` unknown
    - `suggestedValue` unknown
    - `evidence` object, required
      - `excerpt` string, required
      - `locator` string, required
    - `status` 'pending' | 'approved' | 'rejected', required
    - `createdAt` string, required
    - `resolvedAt` string, nullable, required

## Other responses

- `401`: unauthorized
- `429`: rate limited
- `500`: internal error
- `503`: service unavailable

---

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