---
title: "List Agent Suggestions"
method: GET
path: "/v2/agents/{agent_id}/suggestions"
tags: ["Suggestions"]
---

# List Agent Suggestions

`GET /v2/agents/{agent_id}/suggestions`

List an Agent's suggestions. status=pending is the inbox; status=history is consumed/dismissed/auto-cleared. Reads lazily auto-clear stale pending items.

## Path parameters

- `agent_id` string, uuid, required

## Query parameters

- `status` 'pending' | 'history'
- `limit` integer
- `offset` integer

## Response `200`

Default Response

- object
  - `data` union[], required
    - union
      - object
        - `id` string, uuid, required
        - `agent_id` string, uuid, required
        - `status` 'pending' | 'consumed' | 'rejected' | 'superseded', required
        - `generated_by` 'connection_llm' | 'eval' | 'dreaming', required
        - `title` string, required
        - `description` string, required
        - `dedup_key` string, required
        - `resolved_at` string, nullable, required
        - `resolved_by_user_id` string, uuid, nullable, required
        - `superseded_reason` string, nullable, required
        - `superseded_by_suggestion_id` string, uuid, nullable, required
        - `created_at` string, required
        - `updated_at` string, required
        - `sources` object[], required
          - `agent_run_id` string, uuid, required
          - `run_number` integer, required
          - `created_at` string, required
        - `type` 'aop', required
        - `payload` object, required
          - `oldSop` string, required
          - `newSop` string, required
      - object
        - `id` string, uuid, required
        - `agent_id` string, uuid, required
        - `status` 'pending' | 'consumed' | 'rejected' | 'superseded', required
        - `generated_by` 'connection_llm' | 'eval' | 'dreaming', required
        - `title` string, required
        - `description` string, required
        - `dedup_key` string, required
        - `resolved_at` string, nullable, required
        - `resolved_by_user_id` string, uuid, nullable, required
        - `superseded_reason` string, nullable, required
        - `superseded_by_suggestion_id` string, uuid, nullable, required
        - `created_at` string, required
        - `updated_at` string, required
        - `sources` object[], required
          - `agent_run_id` string, uuid, required
          - `run_number` integer, required
          - `created_at` string, required
        - `type` 'connection_add', required
        - `payload` object, required
          - `toSlug` 'googlecalendar' | 'google-calendar' | 'gmail' | 'slack' | 'googledocs' | 'googlesheets' | 'googledrive' | 'firecrawl' | 'exa' | 'exa-search' | 'exa-company-search' | 'exa-people-search' | 'deep-research' | 'system' | 'browser-agent' | 'browser-agent-devtools' | 'notion' | 'linear' | 'confluence' | 'custom_mcp' | 'user_mcp' | 'snowflake' | 'sharepoint' | 'teams' | 'onedrive' | 'bigquery' | 'databricks' | 'netsuite' | 'outlook' | 'microsoft-calendar' | 'excel' | 'word' | 'saps4hana' | 'md365' | 'businesscentral' | 'oraclefusion' | 'workday' | 'coupa' | 'signavio' | 'sap-ecc' | 'msteams' | 'human-in-the-loop' | 'email-attachments-reader' | 'document-processor' | 'google-docs' | 'google-sheets' | 'google-drive' | 'outbound-call' | 'case-queue-producer' | 'case-queue-consumer' | 'handover' | 'shopify' | 'hubspot' | 'zendesk' | 'intercom' | 'powerbi' | 'salesforce' | 'pipedrive' | 'tableau' | 'image-generation' | 'forecasting' | 'supabase' | 'attio' | 'amplitude' | 'websets' | 'firecrawl-platform' | 'duvo-computer-use' | 'duvo-computer-use-rdp' | 'eu-commodity-prices' | 'asana' | 'ssh' | 'scheduling' | 'github' | 'linear-native' | 'notion-native' | 'granola' | 'apify' | 'bamboohr', required
          - `toIntegrationId` string, uuid, required
      - object
        - `id` string, uuid, required
        - `agent_id` string, uuid, required
        - `status` 'pending' | 'consumed' | 'rejected' | 'superseded', required
        - `generated_by` 'connection_llm' | 'eval' | 'dreaming', required
        - `title` string, required
        - `description` string, required
        - `dedup_key` string, required
        - `resolved_at` string, nullable, required
        - `resolved_by_user_id` string, uuid, nullable, required
        - `superseded_reason` string, nullable, required
        - `superseded_by_suggestion_id` string, uuid, nullable, required
        - `created_at` string, required
        - `updated_at` string, required
        - `sources` object[], required
          - `agent_run_id` string, uuid, required
          - `run_number` integer, required
          - `created_at` string, required
        - `type` 'connection_replace', required
        - `payload` object, required
          - `fromSlug` 'googlecalendar' | 'google-calendar' | 'gmail' | 'slack' | 'googledocs' | 'googlesheets' | 'googledrive' | 'firecrawl' | 'exa' | 'exa-search' | 'exa-company-search' | 'exa-people-search' | 'deep-research' | 'system' | 'browser-agent' | 'browser-agent-devtools' | 'notion' | 'linear' | 'confluence' | 'custom_mcp' | 'user_mcp' | 'snowflake' | 'sharepoint' | 'teams' | 'onedrive' | 'bigquery' | 'databricks' | 'netsuite' | 'outlook' | 'microsoft-calendar' | 'excel' | 'word' | 'saps4hana' | 'md365' | 'businesscentral' | 'oraclefusion' | 'workday' | 'coupa' | 'signavio' | 'sap-ecc' | 'msteams' | 'human-in-the-loop' | 'email-attachments-reader' | 'document-processor' | 'google-docs' | 'google-sheets' | 'google-drive' | 'outbound-call' | 'case-queue-producer' | 'case-queue-consumer' | 'handover' | 'shopify' | 'hubspot' | 'zendesk' | 'intercom' | 'powerbi' | 'salesforce' | 'pipedrive' | 'tableau' | 'image-generation' | 'forecasting' | 'supabase' | 'attio' | 'amplitude' | 'websets' | 'firecrawl-platform' | 'duvo-computer-use' | 'duvo-computer-use-rdp' | 'eu-commodity-prices' | 'asana' | 'ssh' | 'scheduling' | 'github' | 'linear-native' | 'notion-native' | 'granola' | 'apify' | 'bamboohr', required
          - `toSlug` 'googlecalendar' | 'google-calendar' | 'gmail' | 'slack' | 'googledocs' | 'googlesheets' | 'googledrive' | 'firecrawl' | 'exa' | 'exa-search' | 'exa-company-search' | 'exa-people-search' | 'deep-research' | 'system' | 'browser-agent' | 'browser-agent-devtools' | 'notion' | 'linear' | 'confluence' | 'custom_mcp' | 'user_mcp' | 'snowflake' | 'sharepoint' | 'teams' | 'onedrive' | 'bigquery' | 'databricks' | 'netsuite' | 'outlook' | 'microsoft-calendar' | 'excel' | 'word' | 'saps4hana' | 'md365' | 'businesscentral' | 'oraclefusion' | 'workday' | 'coupa' | 'signavio' | 'sap-ecc' | 'msteams' | 'human-in-the-loop' | 'email-attachments-reader' | 'document-processor' | 'google-docs' | 'google-sheets' | 'google-drive' | 'outbound-call' | 'case-queue-producer' | 'case-queue-consumer' | 'handover' | 'shopify' | 'hubspot' | 'zendesk' | 'intercom' | 'powerbi' | 'salesforce' | 'pipedrive' | 'tableau' | 'image-generation' | 'forecasting' | 'supabase' | 'attio' | 'amplitude' | 'websets' | 'firecrawl-platform' | 'duvo-computer-use' | 'duvo-computer-use-rdp' | 'eu-commodity-prices' | 'asana' | 'ssh' | 'scheduling' | 'github' | 'linear-native' | 'notion-native' | 'granola' | 'apify' | 'bamboohr', required
          - `toIntegrationId` string, uuid, required
      - object
        - `id` string, uuid, required
        - `agent_id` string, uuid, required
        - `status` 'pending' | 'consumed' | 'rejected' | 'superseded', required
        - `generated_by` 'connection_llm' | 'eval' | 'dreaming', required
        - `title` string, required
        - `description` string, required
        - `dedup_key` string, required
        - `resolved_at` string, nullable, required
        - `resolved_by_user_id` string, uuid, nullable, required
        - `superseded_reason` string, nullable, required
        - `superseded_by_suggestion_id` string, uuid, nullable, required
        - `created_at` string, required
        - `updated_at` string, required
        - `sources` object[], required
          - `agent_run_id` string, uuid, required
          - `run_number` integer, required
          - `created_at` string, required
        - `type` 'connection_remove', required
        - `payload` object, required
          - `slug` 'googlecalendar' | 'google-calendar' | 'gmail' | 'slack' | 'googledocs' | 'googlesheets' | 'googledrive' | 'firecrawl' | 'exa' | 'exa-search' | 'exa-company-search' | 'exa-people-search' | 'deep-research' | 'system' | 'browser-agent' | 'browser-agent-devtools' | 'notion' | 'linear' | 'confluence' | 'custom_mcp' | 'user_mcp' | 'snowflake' | 'sharepoint' | 'teams' | 'onedrive' | 'bigquery' | 'databricks' | 'netsuite' | 'outlook' | 'microsoft-calendar' | 'excel' | 'word' | 'saps4hana' | 'md365' | 'businesscentral' | 'oraclefusion' | 'workday' | 'coupa' | 'signavio' | 'sap-ecc' | 'msteams' | 'human-in-the-loop' | 'email-attachments-reader' | 'document-processor' | 'google-docs' | 'google-sheets' | 'google-drive' | 'outbound-call' | 'case-queue-producer' | 'case-queue-consumer' | 'handover' | 'shopify' | 'hubspot' | 'zendesk' | 'intercom' | 'powerbi' | 'salesforce' | 'pipedrive' | 'tableau' | 'image-generation' | 'forecasting' | 'supabase' | 'attio' | 'amplitude' | 'websets' | 'firecrawl-platform' | 'duvo-computer-use' | 'duvo-computer-use-rdp' | 'eu-commodity-prices' | 'asana' | 'ssh' | 'scheduling' | 'github' | 'linear-native' | 'notion-native' | 'granola' | 'apify' | 'bamboohr', required
  - `pending_count` integer, required

## Other responses

- `401` — Default Response
- `403` — Default Response
- `500` — Default Response

---

[API](https://skmtc.net/duvo/apis/duvo-public-api.md) · [All operations](https://skmtc.net/duvo/apis/duvo-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/duvo/duvo-public-api/versions/dafcf3d868a9/schema)