# Suggestions

Base: `/workspaces/{workspaceId}/suggestions`

## List

`GET .../suggestions?kind=near_duplicate&bucketId=&sync=1&count=1` · `suggestions:read`

| Query | Description |
|-------|-------------|
| `kind` | Suggestion kind (default `person_merge`) |
| `bucketId` | Required for some inventory syncs |
| `sync=1` | Recompute before list |
| `count=1` | Return pending counts by kind (`kind=all` for all) |

## Actions

`POST .../suggestions` · `suggestions:write`

```json
{ "action": "accept", "kind": "cleanup_largest", "ids": ["..."] }
```

| action | Body |
|--------|------|
| `sync` | `kind`, `bucketId?` |
| `accept` | `kind`, `ids[]`, optional `keepBySuggestionId`, `namesBySuggestionId` |
| `dismiss` | `ids[]` |
| `auto-accept` | `kind`, `limit?` |

Accept may trash or move objects depending on kind (respects Trash settings).