get/api/v2/prompt-suggestion-runs

List prompt suggestion generation runs.

Returns recent Prompt Explorer generation runs, including local-source blocked or failure reasons for sitemap and Knowledge Base generation.

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 (queued, running, done, failed, blocked)

limit

query

No description provided.

Schema: integer

Responses

200

Prompt suggestion generation runs.

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
          },
          "status": {
            "type": "string",
            "enum": [
              "queued",
              "running",
              "done",
              "failed",
              "blocked"
            ]
          },
          "countRequested": {
            "type": "integer",
            "nullable": true
          },
          "countCreated": {
            "type": "integer"
          },
          "blockedReason": {
            "type": "string",
            "nullable": true
          },
          "failureReason": {
            "type": "string",
            "nullable": true
          },
          "startedAt": {
            "type": "string",
            "format": "date-time"
          },
          "finishedAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          }
        },
        "required": [
          "id",
          "source",
          "status",
          "countCreated",
          "startedAt"
        ]
      }
    }
  },
  "required": [
    "items"
  ]
}

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.