WWatchLLM
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

NameInDescription
X-Project-IdheaderRequired for organization-wide API keys on project-scoped endpoints. Project-scoped keys infer the project automatically.string
sourcequeryNo description provided.string (google_search_console, manual_search, sitemap, knowledge_base)
statusqueryNo description provided.string (pending, accepted, dismissed, failed)
countryqueryExact country label stored on generated suggestions, such as United States or Japan.string
queryquerySearch seed query, suggested prompt, or rationale.string
cursorqueryOpaque cursor from the previous page.string
limitqueryNo description provided.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.