get/api/v2/prompt-suggestions

List saved prompt suggestions.

Returns Prompt Explorer suggestions generated from Search Console, manual searches, sitemap pages, or Knowledge Base evidence, including source metadata for provenance.

Requires bearer API key

Parameters

X-Project-Id

header

Required for organization-wide API keys on project-scoped endpoints. Project-scoped keys infer the project automatically.

Schema: string

source

query

No description provided.

Schema: string (google_search_console, manual_search, sitemap, knowledge_base)

status

query

No description provided.

Schema: string (pending, accepted, dismissed, failed)

country

query

Exact country label stored on generated suggestions, such as United States or Japan.

Schema: string

query

query

Search seed query, suggested prompt, or rationale.

Schema: string

cursor

query

Opaque cursor from the previous page.

Schema: string

limit

query

No description provided.

Schema: integer

Responses

200

Prompt suggestion list.

application/json
{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true,
        "properties": {
          "id": {
            "type": "string"
          },
          "source": {
            "type": "string",
            "enum": [
              "google_search_console",
              "manual_search",
              "sitemap",
              "knowledge_base"
            ]
          },
          "seedQuery": {
            "type": "string",
            "nullable": true
          },
          "suggestedPrompt": {
            "type": "string"
          },
          "country": {
            "type": "string",
            "nullable": true
          },
          "targetPromptType": {
            "type": "string",
            "enum": [
              "ORGANIC",
              "BRAND_SPECIFIC",
              "COMPETITOR_COMPARISON"
            ]
          },
          "targetPromptIntent": {
            "type": "string",
            "enum": [
              "BRANDED",
              "INFORMATIONAL",
              "COMMERCIAL",
              "TRANSACTIONAL",
              "NAVIGATIONAL"
            ]
          },
          "score": {
            "type": "number",
            "nullable": true
          },
          "rationale": {
            "type": "string",
            "nullable": true
          },
          "sourceMetadata": {
            "type": "object",
            "additionalProperties": true
          },
          "status": {
            "type": "string",
            "enum": [
              "pending",
              "accepted",
              "dismissed",
              "failed"
            ]
          },
          "acceptedMonitorId": {
            "type": "string",
            "nullable": true
          },
          "acceptedPromptId": {
            "type": "string",
            "nullable": true
          },
          "createdAt": {
            "type": "string",
            "format": "date-time"
          },
          "acceptedAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "dismissedAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          }
        },
        "required": [
          "id",
          "source",
          "suggestedPrompt",
          "sourceMetadata",
          "status",
          "createdAt"
        ]
      }
    },
    "nextCursor": {
      "type": "string",
      "nullable": true
    }
  },
  "required": [
    "items",
    "nextCursor"
  ]
}

Try it

Send this request to the local WatchLLM REST handler. Use a key from `/workspace/api`; organization keys can include `X-Project-Id` only when the endpoint documents that header.