@llmpulse/sdk 1.61.0 → 1.63.0

package/src/apis/PromptsApi.ts

@@ -4,7 +4,7 @@
  * LLM Pulse API
  * REST API client for LLM Pulse AI visibility analytics.
  *
- * The version of the OpenAPI document: 1.61.0
+ * The version of the OpenAPI document: 1.63.0
  * Contact: info@llmpulse.ai
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
@@ -18,11 +18,26 @@ import {
     ApiErrorFromJSON,
     ApiErrorToJSON,
 } from '../models/ApiError';
+import {
+    type PromptCategorizationResponse,
+    PromptCategorizationResponseFromJSON,
+    PromptCategorizationResponseToJSON,
+} from '../models/PromptCategorizationResponse';
 import {
     type PromptExecutionsResponse,
     PromptExecutionsResponseFromJSON,
     PromptExecutionsResponseToJSON,
 } from '../models/PromptExecutionsResponse';
+import {
+    type PromptGenerationRequest,
+    PromptGenerationRequestFromJSON,
+    PromptGenerationRequestToJSON,
+} from '../models/PromptGenerationRequest';
+import {
+    type PromptGenerationResponse,
+    PromptGenerationResponseFromJSON,
+    PromptGenerationResponseToJSON,
+} from '../models/PromptGenerationResponse';
 import {
     type PromptsCreateRequest,
     PromptsCreateRequestFromJSON,
@@ -33,11 +48,59 @@ import {
     PromptsCreateResponseFromJSON,
     PromptsCreateResponseToJSON,
 } from '../models/PromptsCreateResponse';
+import {
+    type PromptsImportRequest,
+    PromptsImportRequestFromJSON,
+    PromptsImportRequestToJSON,
+} from '../models/PromptsImportRequest';
+import {
+    type PromptsImportResponse,
+    PromptsImportResponseFromJSON,
+    PromptsImportResponseToJSON,
+} from '../models/PromptsImportResponse';
 import {
     type PromptsResponse,
     PromptsResponseFromJSON,
     PromptsResponseToJSON,
 } from '../models/PromptsResponse';
+import {
+    type SuggestedPromptIdsRequest,
+    SuggestedPromptIdsRequestFromJSON,
+    SuggestedPromptIdsRequestToJSON,
+} from '../models/SuggestedPromptIdsRequest';
+import {
+    type SuggestedPromptsAcceptRequest,
+    SuggestedPromptsAcceptRequestFromJSON,
+    SuggestedPromptsAcceptRequestToJSON,
+} from '../models/SuggestedPromptsAcceptRequest';
+import {
+    type SuggestedPromptsAcceptResponse,
+    SuggestedPromptsAcceptResponseFromJSON,
+    SuggestedPromptsAcceptResponseToJSON,
+} from '../models/SuggestedPromptsAcceptResponse';
+import {
+    type SuggestedPromptsRejectResponse,
+    SuggestedPromptsRejectResponseFromJSON,
+    SuggestedPromptsRejectResponseToJSON,
+} from '../models/SuggestedPromptsRejectResponse';
+import {
+    type SuggestedPromptsResponse,
+    SuggestedPromptsResponseFromJSON,
+    SuggestedPromptsResponseToJSON,
+} from '../models/SuggestedPromptsResponse';
+import {
+    type UpdatePromptRequest,
+    UpdatePromptRequestFromJSON,
+    UpdatePromptRequestToJSON,
+} from '../models/UpdatePromptRequest';
+
+export interface AcceptSuggestedPromptsRequest {
+    suggestedPromptsAcceptRequest: SuggestedPromptsAcceptRequest;
+}
+
+export interface CreatePromptGenerationRequest {
+    promptGenerationRequest: PromptGenerationRequest;
+}
 
 export interface CreatePromptsRequest {
     promptsCreateRequest: PromptsCreateRequest;
@@ -48,6 +111,15 @@ export interface DeletePromptRequest {
     id: number;
 }
 
+export interface GetPromptGenerationRequest {
+    projectId: number;
+    id: string;
+}
+
+export interface ImportPromptsRequest {
+    promptsImportRequest: PromptsImportRequest;
+}
+
 export interface ListPromptExecutionsRequest {
     projectId: number;
     page?: number;
@@ -102,6 +174,23 @@ export interface ListQueryFanOutsRequest {
     output?: ListQueryFanOutsOutputEnum;
 }
 
+export interface ListSuggestedPromptsRequest {
+    projectId: number;
+    source?: ListSuggestedPromptsSourceEnum;
+    status?: ListSuggestedPromptsStatusEnum;
+    page?: number;
+    perPage?: number;
+}
+
+export interface RejectSuggestedPromptsRequest {
+    suggestedPromptIdsRequest: SuggestedPromptIdsRequest;
+}
+
+export interface UpdatePromptOperationRequest {
+    id: number;
+    updatePromptRequest: UpdatePromptRequest;
+}
+
 /**
  * PromptsApi - interface
  * 
@@ -109,6 +198,54 @@ export interface ListQueryFanOutsRequest {
  * @interface PromptsApiInterface
  */
 export interface PromptsApiInterface {
+    /**
+     * Creates request options for acceptSuggestedPrompts without sending the request
+     * @param {SuggestedPromptsAcceptRequest} suggestedPromptsAcceptRequest 
+     * @throws {RequiredError}
+     * @memberof PromptsApiInterface
+     */
+    acceptSuggestedPromptsRequestOpts(requestParameters: AcceptSuggestedPromptsRequest): Promise<runtime.RequestOpts>;
+
+    /**
+     * Starts tracking up to 100 pending suggestions: each becomes a prompt in its own country and language, optionally put in one tag (tag_ids or tag_names; create_missing creates a missing name when the team member may create tags). Suggestions that are no longer pending come back in skipped. When the new prompts would exceed the plan the call returns ERR_LIMIT_REACHED and accepts nothing. Requires a `read_write` scope API key and, for team members, create access to Prompts.
+     * @summary Accept suggested prompts
+     * @param {SuggestedPromptsAcceptRequest} suggestedPromptsAcceptRequest 
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof PromptsApiInterface
+     */
+    acceptSuggestedPromptsRaw(requestParameters: AcceptSuggestedPromptsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<SuggestedPromptsAcceptResponse>>;
+
+    /**
+     * Starts tracking up to 100 pending suggestions: each becomes a prompt in its own country and language, optionally put in one tag (tag_ids or tag_names; create_missing creates a missing name when the team member may create tags). Suggestions that are no longer pending come back in skipped. When the new prompts would exceed the plan the call returns ERR_LIMIT_REACHED and accepts nothing. Requires a `read_write` scope API key and, for team members, create access to Prompts.
+     * Accept suggested prompts
+     */
+    acceptSuggestedPrompts(requestParameters: AcceptSuggestedPromptsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SuggestedPromptsAcceptResponse>;
+
+    /**
+     * Creates request options for createPromptGeneration without sending the request
+     * @param {PromptGenerationRequest} promptGenerationRequest 
+     * @throws {RequiredError}
+     * @memberof PromptsApiInterface
+     */
+    createPromptGenerationRequestOpts(requestParameters: CreatePromptGenerationRequest): Promise<runtime.RequestOpts>;
+
+    /**
+     * Starts a suggestion run with one of the generators behind the app\'s Add prompts wizards and answers 202 with the run. website writes suggestions from the scraped website (80% non-brand, 20% brand; up to 100 per project, then ERR_LIMIT_REACHED), keyword from a keyword or the project profile (optionally around a competitor), topic from a topic, reddit from Reddit discussions of a topic or brand, paa from Google People Also Ask (up to 5 keywords, counted against the account\'s 24-hour lookup allowance), reputational from brand reputation questions, translate from the project\'s prompts of another locale, search_console from the connected property\'s top queries of the last 28 days (Growth plan or above, ERR_PLAN_REQUIRED). The suggestions land in the Suggested prompts queue; poll GET /prompt_generations/{id}, then accept the ones you want with POST /suggested_prompts/accept. Nothing is tracked until accepted. The request is validated before the run starts, and refused with ERR_LIMIT_REACHED when the plan has no prompt slot left, or ERR_QUOTA_EXCEEDED after 60 runs in an hour (the per-user prompt suggestion allowance, shared with project setup). Requires a `read_write` scope API key and, for team members, create access to Prompts.
+     * @summary Generate prompt suggestions
+     * @param {PromptGenerationRequest} promptGenerationRequest 
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof PromptsApiInterface
+     */
+    createPromptGenerationRaw(requestParameters: CreatePromptGenerationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PromptGenerationResponse>>;
+
+    /**
+     * Starts a suggestion run with one of the generators behind the app\'s Add prompts wizards and answers 202 with the run. website writes suggestions from the scraped website (80% non-brand, 20% brand; up to 100 per project, then ERR_LIMIT_REACHED), keyword from a keyword or the project profile (optionally around a competitor), topic from a topic, reddit from Reddit discussions of a topic or brand, paa from Google People Also Ask (up to 5 keywords, counted against the account\'s 24-hour lookup allowance), reputational from brand reputation questions, translate from the project\'s prompts of another locale, search_console from the connected property\'s top queries of the last 28 days (Growth plan or above, ERR_PLAN_REQUIRED). The suggestions land in the Suggested prompts queue; poll GET /prompt_generations/{id}, then accept the ones you want with POST /suggested_prompts/accept. Nothing is tracked until accepted. The request is validated before the run starts, and refused with ERR_LIMIT_REACHED when the plan has no prompt slot left, or ERR_QUOTA_EXCEEDED after 60 runs in an hour (the per-user prompt suggestion allowance, shared with project setup). Requires a `read_write` scope API key and, for team members, create access to Prompts.
+     * Generate prompt suggestions
+     */
+    createPromptGeneration(requestParameters: CreatePromptGenerationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PromptGenerationResponse>;
+
     /**
      * Creates request options for createPrompts without sending the request
      * @param {PromptsCreateRequest} promptsCreateRequest 
@@ -159,6 +296,56 @@ export interface PromptsApiInterface {
      */
     deletePrompt(requestParameters: DeletePromptRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<void>;
 
+    /**
+     * Creates request options for getPromptGeneration without sending the request
+     * @param {number} projectId Project ID
+     * @param {string} id 
+     * @throws {RequiredError}
+     * @memberof PromptsApiInterface
+     */
+    getPromptGenerationRequestOpts(requestParameters: GetPromptGenerationRequest): Promise<runtime.RequestOpts>;
+
+    /**
+     * Returns a run started with POST /prompt_generations: processing while the generator works, then completed with the suggestions it saved to the Suggested prompts queue, or failed with an error code and message. Poll every few seconds; most runs finish within a minute. Runs are kept for 24 hours, their suggestions stay in the queue.
+     * @summary Get a prompt generation run
+     * @param {number} projectId Project ID
+     * @param {string} id 
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof PromptsApiInterface
+     */
+    getPromptGenerationRaw(requestParameters: GetPromptGenerationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PromptGenerationResponse>>;
+
+    /**
+     * Returns a run started with POST /prompt_generations: processing while the generator works, then completed with the suggestions it saved to the Suggested prompts queue, or failed with an error code and message. Poll every few seconds; most runs finish within a minute. Runs are kept for 24 hours, their suggestions stay in the queue.
+     * Get a prompt generation run
+     */
+    getPromptGeneration(requestParameters: GetPromptGenerationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PromptGenerationResponse>;
+
+    /**
+     * Creates request options for importPrompts without sending the request
+     * @param {PromptsImportRequest} promptsImportRequest 
+     * @throws {RequiredError}
+     * @memberof PromptsApiInterface
+     */
+    importPromptsRequestOpts(requestParameters: ImportPromptsRequest): Promise<runtime.RequestOpts>;
+
+    /**
+     * The app\'s CSV import as JSON: up to 500 rows, each with its own prompt, country_code, language_code (codes or names; both default to the project\'s) and tags, created when missing. Duplicates are skipped and existing prompts still get the row\'s tags. The prompt limits are checked before anything is written: when the new prompts would exceed the plan the call returns ERR_LIMIT_REACHED and imports nothing. Rows with an unknown country or language come back in row_errors. Responds 201 when it created prompts, 200 otherwise. Requires a `read_write` scope API key and, for team members, create access to Prompts.
+     * @summary Import prompts
+     * @param {PromptsImportRequest} promptsImportRequest 
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof PromptsApiInterface
+     */
+    importPromptsRaw(requestParameters: ImportPromptsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PromptsImportResponse>>;
+
+    /**
+     * The app\'s CSV import as JSON: up to 500 rows, each with its own prompt, country_code, language_code (codes or names; both default to the project\'s) and tags, created when missing. Duplicates are skipped and existing prompts still get the row\'s tags. The prompt limits are checked before anything is written: when the new prompts would exceed the plan the call returns ERR_LIMIT_REACHED and imports nothing. Rows with an unknown country or language come back in row_errors. Responds 201 when it created prompts, 200 otherwise. Requires a `read_write` scope API key and, for team members, create access to Prompts.
+     * Import prompts
+     */
+    importPrompts(requestParameters: ImportPromptsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PromptsImportResponse>;
+
     /**
      * Creates request options for listPromptExecutions without sending the request
      * @param {number} projectId Project ID
@@ -313,6 +500,88 @@ export interface PromptsApiInterface {
      */
     listQueryFanOuts(requestParameters: ListQueryFanOutsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<void>;
 
+    /**
+     * Creates request options for listSuggestedPrompts without sending the request
+     * @param {number} projectId Project ID
+     * @param {'website' | 'magic' | 'paa' | 'topic' | 'reddit' | 'reputational' | 'gsc' | 'translate' | 'catalog'} [source] Only suggestions from this generator
+     * @param {'pending' | 'accepted' | 'rejected' | 'all'} [status] Only suggestions in this status
+     * @param {number} [page] 
+     * @param {number} [perPage] 
+     * @throws {RequiredError}
+     * @memberof PromptsApiInterface
+     */
+    listSuggestedPromptsRequestOpts(requestParameters: ListSuggestedPromptsRequest): Promise<runtime.RequestOpts>;
+
+    /**
+     * Lists the project\'s Suggested prompts queue, the same list the app\'s Suggested Prompts tab shows, oldest first. It holds the suggestions of every generator (website, magic for keyword runs, topic, reddit, paa, reputational, translate, gsc for Search Console, catalog). Pending suggestions by default; status=all also returns accepted (with the prompt they became) and rejected ones. Team members need create access to Prompts, like the app\'s tab.
+     * @summary List suggested prompts
+     * @param {number} projectId Project ID
+     * @param {'website' | 'magic' | 'paa' | 'topic' | 'reddit' | 'reputational' | 'gsc' | 'translate' | 'catalog'} [source] Only suggestions from this generator
+     * @param {'pending' | 'accepted' | 'rejected' | 'all'} [status] Only suggestions in this status
+     * @param {number} [page] 
+     * @param {number} [perPage] 
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof PromptsApiInterface
+     */
+    listSuggestedPromptsRaw(requestParameters: ListSuggestedPromptsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<SuggestedPromptsResponse>>;
+
+    /**
+     * Lists the project\'s Suggested prompts queue, the same list the app\'s Suggested Prompts tab shows, oldest first. It holds the suggestions of every generator (website, magic for keyword runs, topic, reddit, paa, reputational, translate, gsc for Search Console, catalog). Pending suggestions by default; status=all also returns accepted (with the prompt they became) and rejected ones. Team members need create access to Prompts, like the app\'s tab.
+     * List suggested prompts
+     */
+    listSuggestedPrompts(requestParameters: ListSuggestedPromptsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SuggestedPromptsResponse>;
+
+    /**
+     * Creates request options for rejectSuggestedPrompts without sending the request
+     * @param {SuggestedPromptIdsRequest} suggestedPromptIdsRequest 
+     * @throws {RequiredError}
+     * @memberof PromptsApiInterface
+     */
+    rejectSuggestedPromptsRequestOpts(requestParameters: RejectSuggestedPromptsRequest): Promise<runtime.RequestOpts>;
+
+    /**
+     * Marks up to 100 pending suggestions as rejected, so they leave the pending list; suggestions that are no longer pending stay as they are. Tracks and deletes nothing. Requires a `read_write` scope API key and, for team members, create access to Prompts.
+     * @summary Reject suggested prompts
+     * @param {SuggestedPromptIdsRequest} suggestedPromptIdsRequest 
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof PromptsApiInterface
+     */
+    rejectSuggestedPromptsRaw(requestParameters: RejectSuggestedPromptsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<SuggestedPromptsRejectResponse>>;
+
+    /**
+     * Marks up to 100 pending suggestions as rejected, so they leave the pending list; suggestions that are no longer pending stay as they are. Tracks and deletes nothing. Requires a `read_write` scope API key and, for team members, create access to Prompts.
+     * Reject suggested prompts
+     */
+    rejectSuggestedPrompts(requestParameters: RejectSuggestedPromptsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SuggestedPromptsRejectResponse>;
+
+    /**
+     * Creates request options for updatePrompt without sending the request
+     * @param {number} id 
+     * @param {UpdatePromptRequest} updatePromptRequest 
+     * @throws {RequiredError}
+     * @memberof PromptsApiInterface
+     */
+    updatePromptRequestOpts(requestParameters: UpdatePromptOperationRequest): Promise<runtime.RequestOpts>;
+
+    /**
+     * Manual categorization, exactly like editing the intent and brand badges on the prompt page: send `prompt_type`, `brand_kind` or both. The prompt is marked as manually categorized (`categorization_source` becomes `manual`), so automatic categorization no longer changes it; the prompt page can revert it to automatic. Any other field returns ERR_INVALID_PARAM. Not available from a white-label portal (ERR_INTEGRATION_UNAVAILABLE), where the page hides the editor. Requires a `read_write` scope API key and, for team members, update permission on Prompts.
+     * @summary Edit a prompt\'s categorization
+     * @param {number} id 
+     * @param {UpdatePromptRequest} updatePromptRequest 
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof PromptsApiInterface
+     */
+    updatePromptRaw(requestParameters: UpdatePromptOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PromptCategorizationResponse>>;
+
+    /**
+     * Manual categorization, exactly like editing the intent and brand badges on the prompt page: send `prompt_type`, `brand_kind` or both. The prompt is marked as manually categorized (`categorization_source` becomes `manual`), so automatic categorization no longer changes it; the prompt page can revert it to automatic. Any other field returns ERR_INVALID_PARAM. Not available from a white-label portal (ERR_INTEGRATION_UNAVAILABLE), where the page hides the editor. Requires a `read_write` scope API key and, for team members, update permission on Prompts.
+     * Edit a prompt\'s categorization
+     */
+    updatePrompt(requestParameters: UpdatePromptOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PromptCategorizationResponse>;
+
 }
 
 /**
@@ -320,6 +589,120 @@ export interface PromptsApiInterface {
  */
 export class PromptsApi extends runtime.BaseAPI implements PromptsApiInterface {
 
+    /**
+     * Creates request options for acceptSuggestedPrompts without sending the request
+     */
+    async acceptSuggestedPromptsRequestOpts(requestParameters: AcceptSuggestedPromptsRequest): Promise<runtime.RequestOpts> {
+        if (requestParameters['suggestedPromptsAcceptRequest'] == null) {
+            throw new runtime.RequiredError(
+                'suggestedPromptsAcceptRequest',
+                'Required parameter "suggestedPromptsAcceptRequest" was null or undefined when calling acceptSuggestedPrompts().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        headerParameters['Content-Type'] = 'application/json';
+
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token("BearerAuth", []);
+
+            if (tokenString) {
+                headerParameters["Authorization"] = `Bearer ${tokenString}`;
+            }
+        }
+
+        let urlPath = `/suggested_prompts/accept`;
+
+        return {
+            path: urlPath,
+            method: 'POST',
+            headers: headerParameters,
+            query: queryParameters,
+            body: SuggestedPromptsAcceptRequestToJSON(requestParameters['suggestedPromptsAcceptRequest']),
+        };
+    }
+
+    /**
+     * Starts tracking up to 100 pending suggestions: each becomes a prompt in its own country and language, optionally put in one tag (tag_ids or tag_names; create_missing creates a missing name when the team member may create tags). Suggestions that are no longer pending come back in skipped. When the new prompts would exceed the plan the call returns ERR_LIMIT_REACHED and accepts nothing. Requires a `read_write` scope API key and, for team members, create access to Prompts.
+     * Accept suggested prompts
+     */
+    async acceptSuggestedPromptsRaw(requestParameters: AcceptSuggestedPromptsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<SuggestedPromptsAcceptResponse>> {
+        const requestOptions = await this.acceptSuggestedPromptsRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => SuggestedPromptsAcceptResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * Starts tracking up to 100 pending suggestions: each becomes a prompt in its own country and language, optionally put in one tag (tag_ids or tag_names; create_missing creates a missing name when the team member may create tags). Suggestions that are no longer pending come back in skipped. When the new prompts would exceed the plan the call returns ERR_LIMIT_REACHED and accepts nothing. Requires a `read_write` scope API key and, for team members, create access to Prompts.
+     * Accept suggested prompts
+     */
+    async acceptSuggestedPrompts(requestParameters: AcceptSuggestedPromptsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SuggestedPromptsAcceptResponse> {
+        const response = await this.acceptSuggestedPromptsRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+    /**
+     * Creates request options for createPromptGeneration without sending the request
+     */
+    async createPromptGenerationRequestOpts(requestParameters: CreatePromptGenerationRequest): Promise<runtime.RequestOpts> {
+        if (requestParameters['promptGenerationRequest'] == null) {
+            throw new runtime.RequiredError(
+                'promptGenerationRequest',
+                'Required parameter "promptGenerationRequest" was null or undefined when calling createPromptGeneration().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        headerParameters['Content-Type'] = 'application/json';
+
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token("BearerAuth", []);
+
+            if (tokenString) {
+                headerParameters["Authorization"] = `Bearer ${tokenString}`;
+            }
+        }
+
+        let urlPath = `/prompt_generations`;
+
+        return {
+            path: urlPath,
+            method: 'POST',
+            headers: headerParameters,
+            query: queryParameters,
+            body: PromptGenerationRequestToJSON(requestParameters['promptGenerationRequest']),
+        };
+    }
+
+    /**
+     * Starts a suggestion run with one of the generators behind the app\'s Add prompts wizards and answers 202 with the run. website writes suggestions from the scraped website (80% non-brand, 20% brand; up to 100 per project, then ERR_LIMIT_REACHED), keyword from a keyword or the project profile (optionally around a competitor), topic from a topic, reddit from Reddit discussions of a topic or brand, paa from Google People Also Ask (up to 5 keywords, counted against the account\'s 24-hour lookup allowance), reputational from brand reputation questions, translate from the project\'s prompts of another locale, search_console from the connected property\'s top queries of the last 28 days (Growth plan or above, ERR_PLAN_REQUIRED). The suggestions land in the Suggested prompts queue; poll GET /prompt_generations/{id}, then accept the ones you want with POST /suggested_prompts/accept. Nothing is tracked until accepted. The request is validated before the run starts, and refused with ERR_LIMIT_REACHED when the plan has no prompt slot left, or ERR_QUOTA_EXCEEDED after 60 runs in an hour (the per-user prompt suggestion allowance, shared with project setup). Requires a `read_write` scope API key and, for team members, create access to Prompts.
+     * Generate prompt suggestions
+     */
+    async createPromptGenerationRaw(requestParameters: CreatePromptGenerationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PromptGenerationResponse>> {
+        const requestOptions = await this.createPromptGenerationRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => PromptGenerationResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * Starts a suggestion run with one of the generators behind the app\'s Add prompts wizards and answers 202 with the run. website writes suggestions from the scraped website (80% non-brand, 20% brand; up to 100 per project, then ERR_LIMIT_REACHED), keyword from a keyword or the project profile (optionally around a competitor), topic from a topic, reddit from Reddit discussions of a topic or brand, paa from Google People Also Ask (up to 5 keywords, counted against the account\'s 24-hour lookup allowance), reputational from brand reputation questions, translate from the project\'s prompts of another locale, search_console from the connected property\'s top queries of the last 28 days (Growth plan or above, ERR_PLAN_REQUIRED). The suggestions land in the Suggested prompts queue; poll GET /prompt_generations/{id}, then accept the ones you want with POST /suggested_prompts/accept. Nothing is tracked until accepted. The request is validated before the run starts, and refused with ERR_LIMIT_REACHED when the plan has no prompt slot left, or ERR_QUOTA_EXCEEDED after 60 runs in an hour (the per-user prompt suggestion allowance, shared with project setup). Requires a `read_write` scope API key and, for team members, create access to Prompts.
+     * Generate prompt suggestions
+     */
+    async createPromptGeneration(requestParameters: CreatePromptGenerationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PromptGenerationResponse> {
+        const response = await this.createPromptGenerationRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
     /**
      * Creates request options for createPrompts without sending the request
      */
@@ -442,6 +825,129 @@ export class PromptsApi extends runtime.BaseAPI implements PromptsApiInterface {
         await this.deletePromptRaw(requestParameters, initOverrides);
     }
 
+    /**
+     * Creates request options for getPromptGeneration without sending the request
+     */
+    async getPromptGenerationRequestOpts(requestParameters: GetPromptGenerationRequest): Promise<runtime.RequestOpts> {
+        if (requestParameters['projectId'] == null) {
+            throw new runtime.RequiredError(
+                'projectId',
+                'Required parameter "projectId" was null or undefined when calling getPromptGeneration().'
+            );
+        }
+
+        if (requestParameters['id'] == null) {
+            throw new runtime.RequiredError(
+                'id',
+                'Required parameter "id" was null or undefined when calling getPromptGeneration().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        if (requestParameters['projectId'] != null) {
+            queryParameters['project_id'] = requestParameters['projectId'];
+        }
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token("BearerAuth", []);
+
+            if (tokenString) {
+                headerParameters["Authorization"] = `Bearer ${tokenString}`;
+            }
+        }
+
+        let urlPath = `/prompt_generations/{id}`;
+        urlPath = urlPath.replace('{id}', encodeURIComponent(String(requestParameters['id'])));
+
+        return {
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        };
+    }
+
+    /**
+     * Returns a run started with POST /prompt_generations: processing while the generator works, then completed with the suggestions it saved to the Suggested prompts queue, or failed with an error code and message. Poll every few seconds; most runs finish within a minute. Runs are kept for 24 hours, their suggestions stay in the queue.
+     * Get a prompt generation run
+     */
+    async getPromptGenerationRaw(requestParameters: GetPromptGenerationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PromptGenerationResponse>> {
+        const requestOptions = await this.getPromptGenerationRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => PromptGenerationResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * Returns a run started with POST /prompt_generations: processing while the generator works, then completed with the suggestions it saved to the Suggested prompts queue, or failed with an error code and message. Poll every few seconds; most runs finish within a minute. Runs are kept for 24 hours, their suggestions stay in the queue.
+     * Get a prompt generation run
+     */
+    async getPromptGeneration(requestParameters: GetPromptGenerationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PromptGenerationResponse> {
+        const response = await this.getPromptGenerationRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+    /**
+     * Creates request options for importPrompts without sending the request
+     */
+    async importPromptsRequestOpts(requestParameters: ImportPromptsRequest): Promise<runtime.RequestOpts> {
+        if (requestParameters['promptsImportRequest'] == null) {
+            throw new runtime.RequiredError(
+                'promptsImportRequest',
+                'Required parameter "promptsImportRequest" was null or undefined when calling importPrompts().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        headerParameters['Content-Type'] = 'application/json';
+
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token("BearerAuth", []);
+
+            if (tokenString) {
+                headerParameters["Authorization"] = `Bearer ${tokenString}`;
+            }
+        }
+
+        let urlPath = `/prompts/import`;
+
+        return {
+            path: urlPath,
+            method: 'POST',
+            headers: headerParameters,
+            query: queryParameters,
+            body: PromptsImportRequestToJSON(requestParameters['promptsImportRequest']),
+        };
+    }
+
+    /**
+     * The app\'s CSV import as JSON: up to 500 rows, each with its own prompt, country_code, language_code (codes or names; both default to the project\'s) and tags, created when missing. Duplicates are skipped and existing prompts still get the row\'s tags. The prompt limits are checked before anything is written: when the new prompts would exceed the plan the call returns ERR_LIMIT_REACHED and imports nothing. Rows with an unknown country or language come back in row_errors. Responds 201 when it created prompts, 200 otherwise. Requires a `read_write` scope API key and, for team members, create access to Prompts.
+     * Import prompts
+     */
+    async importPromptsRaw(requestParameters: ImportPromptsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PromptsImportResponse>> {
+        const requestOptions = await this.importPromptsRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => PromptsImportResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * The app\'s CSV import as JSON: up to 500 rows, each with its own prompt, country_code, language_code (codes or names; both default to the project\'s) and tags, created when missing. Duplicates are skipped and existing prompts still get the row\'s tags. The prompt limits are checked before anything is written: when the new prompts would exceed the plan the call returns ERR_LIMIT_REACHED and imports nothing. Rows with an unknown country or language come back in row_errors. Responds 201 when it created prompts, 200 otherwise. Requires a `read_write` scope API key and, for team members, create access to Prompts.
+     * Import prompts
+     */
+    async importPrompts(requestParameters: ImportPromptsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PromptsImportResponse> {
+        const response = await this.importPromptsRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
     /**
      * Creates request options for listPromptExecutions without sending the request
      */
@@ -779,6 +1285,202 @@ export class PromptsApi extends runtime.BaseAPI implements PromptsApiInterface {
         await this.listQueryFanOutsRaw(requestParameters, initOverrides);
     }
 
+    /**
+     * Creates request options for listSuggestedPrompts without sending the request
+     */
+    async listSuggestedPromptsRequestOpts(requestParameters: ListSuggestedPromptsRequest): Promise<runtime.RequestOpts> {
+        if (requestParameters['projectId'] == null) {
+            throw new runtime.RequiredError(
+                'projectId',
+                'Required parameter "projectId" was null or undefined when calling listSuggestedPrompts().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        if (requestParameters['projectId'] != null) {
+            queryParameters['project_id'] = requestParameters['projectId'];
+        }
+
+        if (requestParameters['source'] != null) {
+            queryParameters['source'] = requestParameters['source'];
+        }
+
+        if (requestParameters['status'] != null) {
+            queryParameters['status'] = requestParameters['status'];
+        }
+
+        if (requestParameters['page'] != null) {
+            queryParameters['page'] = requestParameters['page'];
+        }
+
+        if (requestParameters['perPage'] != null) {
+            queryParameters['per_page'] = requestParameters['perPage'];
+        }
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token("BearerAuth", []);
+
+            if (tokenString) {
+                headerParameters["Authorization"] = `Bearer ${tokenString}`;
+            }
+        }
+
+        let urlPath = `/suggested_prompts`;
+
+        return {
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        };
+    }
+
+    /**
+     * Lists the project\'s Suggested prompts queue, the same list the app\'s Suggested Prompts tab shows, oldest first. It holds the suggestions of every generator (website, magic for keyword runs, topic, reddit, paa, reputational, translate, gsc for Search Console, catalog). Pending suggestions by default; status=all also returns accepted (with the prompt they became) and rejected ones. Team members need create access to Prompts, like the app\'s tab.
+     * List suggested prompts
+     */
+    async listSuggestedPromptsRaw(requestParameters: ListSuggestedPromptsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<SuggestedPromptsResponse>> {
+        const requestOptions = await this.listSuggestedPromptsRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => SuggestedPromptsResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * Lists the project\'s Suggested prompts queue, the same list the app\'s Suggested Prompts tab shows, oldest first. It holds the suggestions of every generator (website, magic for keyword runs, topic, reddit, paa, reputational, translate, gsc for Search Console, catalog). Pending suggestions by default; status=all also returns accepted (with the prompt they became) and rejected ones. Team members need create access to Prompts, like the app\'s tab.
+     * List suggested prompts
+     */
+    async listSuggestedPrompts(requestParameters: ListSuggestedPromptsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SuggestedPromptsResponse> {
+        const response = await this.listSuggestedPromptsRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+    /**
+     * Creates request options for rejectSuggestedPrompts without sending the request
+     */
+    async rejectSuggestedPromptsRequestOpts(requestParameters: RejectSuggestedPromptsRequest): Promise<runtime.RequestOpts> {
+        if (requestParameters['suggestedPromptIdsRequest'] == null) {
+            throw new runtime.RequiredError(
+                'suggestedPromptIdsRequest',
+                'Required parameter "suggestedPromptIdsRequest" was null or undefined when calling rejectSuggestedPrompts().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        headerParameters['Content-Type'] = 'application/json';
+
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token("BearerAuth", []);
+
+            if (tokenString) {
+                headerParameters["Authorization"] = `Bearer ${tokenString}`;
+            }
+        }
+
+        let urlPath = `/suggested_prompts/reject`;
+
+        return {
+            path: urlPath,
+            method: 'POST',
+            headers: headerParameters,
+            query: queryParameters,
+            body: SuggestedPromptIdsRequestToJSON(requestParameters['suggestedPromptIdsRequest']),
+        };
+    }
+
+    /**
+     * Marks up to 100 pending suggestions as rejected, so they leave the pending list; suggestions that are no longer pending stay as they are. Tracks and deletes nothing. Requires a `read_write` scope API key and, for team members, create access to Prompts.
+     * Reject suggested prompts
+     */
+    async rejectSuggestedPromptsRaw(requestParameters: RejectSuggestedPromptsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<SuggestedPromptsRejectResponse>> {
+        const requestOptions = await this.rejectSuggestedPromptsRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => SuggestedPromptsRejectResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * Marks up to 100 pending suggestions as rejected, so they leave the pending list; suggestions that are no longer pending stay as they are. Tracks and deletes nothing. Requires a `read_write` scope API key and, for team members, create access to Prompts.
+     * Reject suggested prompts
+     */
+    async rejectSuggestedPrompts(requestParameters: RejectSuggestedPromptsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SuggestedPromptsRejectResponse> {
+        const response = await this.rejectSuggestedPromptsRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+    /**
+     * Creates request options for updatePrompt without sending the request
+     */
+    async updatePromptRequestOpts(requestParameters: UpdatePromptOperationRequest): Promise<runtime.RequestOpts> {
+        if (requestParameters['id'] == null) {
+            throw new runtime.RequiredError(
+                'id',
+                'Required parameter "id" was null or undefined when calling updatePrompt().'
+            );
+        }
+
+        if (requestParameters['updatePromptRequest'] == null) {
+            throw new runtime.RequiredError(
+                'updatePromptRequest',
+                'Required parameter "updatePromptRequest" was null or undefined when calling updatePrompt().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        headerParameters['Content-Type'] = 'application/json';
+
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token("BearerAuth", []);
+
+            if (tokenString) {
+                headerParameters["Authorization"] = `Bearer ${tokenString}`;
+            }
+        }
+
+        let urlPath = `/prompts/{id}`;
+        urlPath = urlPath.replace('{id}', encodeURIComponent(String(requestParameters['id'])));
+
+        return {
+            path: urlPath,
+            method: 'PATCH',
+            headers: headerParameters,
+            query: queryParameters,
+            body: UpdatePromptRequestToJSON(requestParameters['updatePromptRequest']),
+        };
+    }
+
+    /**
+     * Manual categorization, exactly like editing the intent and brand badges on the prompt page: send `prompt_type`, `brand_kind` or both. The prompt is marked as manually categorized (`categorization_source` becomes `manual`), so automatic categorization no longer changes it; the prompt page can revert it to automatic. Any other field returns ERR_INVALID_PARAM. Not available from a white-label portal (ERR_INTEGRATION_UNAVAILABLE), where the page hides the editor. Requires a `read_write` scope API key and, for team members, update permission on Prompts.
+     * Edit a prompt\'s categorization
+     */
+    async updatePromptRaw(requestParameters: UpdatePromptOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PromptCategorizationResponse>> {
+        const requestOptions = await this.updatePromptRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => PromptCategorizationResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * Manual categorization, exactly like editing the intent and brand badges on the prompt page: send `prompt_type`, `brand_kind` or both. The prompt is marked as manually categorized (`categorization_source` becomes `manual`), so automatic categorization no longer changes it; the prompt page can revert it to automatic. Any other field returns ERR_INVALID_PARAM. Not available from a white-label portal (ERR_INTEGRATION_UNAVAILABLE), where the page hides the editor. Requires a `read_write` scope API key and, for team members, update permission on Prompts.
+     * Edit a prompt\'s categorization
+     */
+    async updatePrompt(requestParameters: UpdatePromptOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PromptCategorizationResponse> {
+        const response = await this.updatePromptRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
 }
 
 /**
@@ -936,3 +1638,28 @@ export const ListQueryFanOutsOutputEnum = {
     Csv: 'csv'
 } as const;
 export type ListQueryFanOutsOutputEnum = typeof ListQueryFanOutsOutputEnum[keyof typeof ListQueryFanOutsOutputEnum];
+/**
+ * @export
+ */
+export const ListSuggestedPromptsSourceEnum = {
+    Website: 'website',
+    Magic: 'magic',
+    Paa: 'paa',
+    Topic: 'topic',
+    Reddit: 'reddit',
+    Reputational: 'reputational',
+    Gsc: 'gsc',
+    Translate: 'translate',
+    Catalog: 'catalog'
+} as const;
+export type ListSuggestedPromptsSourceEnum = typeof ListSuggestedPromptsSourceEnum[keyof typeof ListSuggestedPromptsSourceEnum];
+/**
+ * @export
+ */
+export const ListSuggestedPromptsStatusEnum = {
+    Pending: 'pending',
+    Accepted: 'accepted',
+    Rejected: 'rejected',
+    All: 'all'
+} as const;
+export type ListSuggestedPromptsStatusEnum = typeof ListSuggestedPromptsStatusEnum[keyof typeof ListSuggestedPromptsStatusEnum];