@nuxtseo/protocol 0.5.3 → 0.5.5

package/dist/v1/gsc.d.ts

@@ -4257,6 +4257,392 @@ export declare const urlInspectionReadOperation: {
         }];
     };
 };
+export declare const urlInspectionRefreshBodySchema: z.ZodObject<{
+    url: z.ZodString;
+}, z.core.$strict>;
+export declare const urlInspectionRefreshDataSchema: {
+    producer: z.ZodObject<{
+        siteId: z.ZodString;
+        rateLimit: z.ZodObject<{
+            reserved: z.ZodNumber;
+            remaining: z.ZodNumber;
+            limit: z.ZodNumber;
+        }, z.core.$loose>;
+        results: z.ZodArray<z.ZodObject<{
+            url: z.ZodString;
+            verdict: z.ZodNullable<z.ZodString>;
+            coverageState: z.ZodNullable<z.ZodString>;
+            indexingState: z.ZodNullable<z.ZodString>;
+            robotsTxtState: z.ZodNullable<z.ZodString>;
+            pageFetchState: z.ZodNullable<z.ZodString>;
+            lastCrawlTime: z.ZodNullable<z.ZodString>;
+            crawlingUserAgent: z.ZodNullable<z.ZodString>;
+            userCanonical: z.ZodNullable<z.ZodString>;
+            googleCanonical: z.ZodNullable<z.ZodString>;
+            sitemaps: z.ZodNullable<z.ZodString>;
+            referringUrls: z.ZodNullable<z.ZodString>;
+            mobileVerdict: z.ZodNullable<z.ZodString>;
+            mobileIssues: z.ZodNullable<z.ZodString>;
+            richResultsVerdict: z.ZodNullable<z.ZodString>;
+            richResultsItems: z.ZodNullable<z.ZodString>;
+            inspectionResultLink: z.ZodNullable<z.ZodString>;
+        }, z.core.$loose>>;
+        errors: z.ZodArray<z.ZodObject<{
+            url: z.ZodString;
+            error: z.ZodString;
+        }, z.core.$loose>>;
+        skipped: z.ZodArray<z.ZodObject<{
+            url: z.ZodString;
+            reason: z.ZodString;
+        }, z.core.$loose>>;
+        checkedAt: z.ZodISODateTime;
+    }, z.core.$strict>;
+    client: z.ZodObject<{
+        siteId: z.ZodString;
+        rateLimit: z.ZodObject<{
+            reserved: z.ZodNumber;
+            remaining: z.ZodNumber;
+            limit: z.ZodNumber;
+        }, z.core.$loose>;
+        results: z.ZodArray<z.ZodObject<{
+            url: z.ZodString;
+            verdict: z.ZodNullable<z.ZodString>;
+            coverageState: z.ZodNullable<z.ZodString>;
+            indexingState: z.ZodNullable<z.ZodString>;
+            robotsTxtState: z.ZodNullable<z.ZodString>;
+            pageFetchState: z.ZodNullable<z.ZodString>;
+            lastCrawlTime: z.ZodNullable<z.ZodString>;
+            crawlingUserAgent: z.ZodNullable<z.ZodString>;
+            userCanonical: z.ZodNullable<z.ZodString>;
+            googleCanonical: z.ZodNullable<z.ZodString>;
+            sitemaps: z.ZodNullable<z.ZodString>;
+            referringUrls: z.ZodNullable<z.ZodString>;
+            mobileVerdict: z.ZodNullable<z.ZodString>;
+            mobileIssues: z.ZodNullable<z.ZodString>;
+            richResultsVerdict: z.ZodNullable<z.ZodString>;
+            richResultsItems: z.ZodNullable<z.ZodString>;
+            inspectionResultLink: z.ZodNullable<z.ZodString>;
+        }, z.core.$loose>>;
+        errors: z.ZodArray<z.ZodObject<{
+            url: z.ZodString;
+            error: z.ZodString;
+        }, z.core.$loose>>;
+        skipped: z.ZodArray<z.ZodObject<{
+            url: z.ZodString;
+            reason: z.ZodString;
+        }, z.core.$loose>>;
+        checkedAt: z.ZodISODateTime;
+    }, z.core.$loose>;
+};
+export declare const urlInspectionRefreshResponseSchema: import("./core.js").CompatibleResponseSchema<z.ZodObject<{
+    data: z.ZodObject<{
+        siteId: z.ZodString;
+        rateLimit: z.ZodObject<{
+            reserved: z.ZodNumber;
+            remaining: z.ZodNumber;
+            limit: z.ZodNumber;
+        }, z.core.$loose>;
+        results: z.ZodArray<z.ZodObject<{
+            url: z.ZodString;
+            verdict: z.ZodNullable<z.ZodString>;
+            coverageState: z.ZodNullable<z.ZodString>;
+            indexingState: z.ZodNullable<z.ZodString>;
+            robotsTxtState: z.ZodNullable<z.ZodString>;
+            pageFetchState: z.ZodNullable<z.ZodString>;
+            lastCrawlTime: z.ZodNullable<z.ZodString>;
+            crawlingUserAgent: z.ZodNullable<z.ZodString>;
+            userCanonical: z.ZodNullable<z.ZodString>;
+            googleCanonical: z.ZodNullable<z.ZodString>;
+            sitemaps: z.ZodNullable<z.ZodString>;
+            referringUrls: z.ZodNullable<z.ZodString>;
+            mobileVerdict: z.ZodNullable<z.ZodString>;
+            mobileIssues: z.ZodNullable<z.ZodString>;
+            richResultsVerdict: z.ZodNullable<z.ZodString>;
+            richResultsItems: z.ZodNullable<z.ZodString>;
+            inspectionResultLink: z.ZodNullable<z.ZodString>;
+        }, z.core.$loose>>;
+        errors: z.ZodArray<z.ZodObject<{
+            url: z.ZodString;
+            error: z.ZodString;
+        }, z.core.$loose>>;
+        skipped: z.ZodArray<z.ZodObject<{
+            url: z.ZodString;
+            reason: z.ZodString;
+        }, z.core.$loose>>;
+        checkedAt: z.ZodISODateTime;
+    }, z.core.$strict>;
+    meta: z.ZodObject<{
+        requestId: z.ZodString;
+        version: z.ZodLiteral<"1.0">;
+    }, z.core.$strict>;
+}, z.core.$strip>, z.ZodObject<{
+    data: z.ZodObject<{
+        siteId: z.ZodString;
+        rateLimit: z.ZodObject<{
+            reserved: z.ZodNumber;
+            remaining: z.ZodNumber;
+            limit: z.ZodNumber;
+        }, z.core.$loose>;
+        results: z.ZodArray<z.ZodObject<{
+            url: z.ZodString;
+            verdict: z.ZodNullable<z.ZodString>;
+            coverageState: z.ZodNullable<z.ZodString>;
+            indexingState: z.ZodNullable<z.ZodString>;
+            robotsTxtState: z.ZodNullable<z.ZodString>;
+            pageFetchState: z.ZodNullable<z.ZodString>;
+            lastCrawlTime: z.ZodNullable<z.ZodString>;
+            crawlingUserAgent: z.ZodNullable<z.ZodString>;
+            userCanonical: z.ZodNullable<z.ZodString>;
+            googleCanonical: z.ZodNullable<z.ZodString>;
+            sitemaps: z.ZodNullable<z.ZodString>;
+            referringUrls: z.ZodNullable<z.ZodString>;
+            mobileVerdict: z.ZodNullable<z.ZodString>;
+            mobileIssues: z.ZodNullable<z.ZodString>;
+            richResultsVerdict: z.ZodNullable<z.ZodString>;
+            richResultsItems: z.ZodNullable<z.ZodString>;
+            inspectionResultLink: z.ZodNullable<z.ZodString>;
+        }, z.core.$loose>>;
+        errors: z.ZodArray<z.ZodObject<{
+            url: z.ZodString;
+            error: z.ZodString;
+        }, z.core.$loose>>;
+        skipped: z.ZodArray<z.ZodObject<{
+            url: z.ZodString;
+            reason: z.ZodString;
+        }, z.core.$loose>>;
+        checkedAt: z.ZodISODateTime;
+    }, z.core.$loose>;
+    meta: z.ZodObject<{
+        requestId: z.ZodString;
+        version: z.ZodLiteral<"1.0">;
+    }, z.core.$loose>;
+}, z.core.$strip>>;
+export type UrlInspectionRefreshData = z.output<typeof urlInspectionRefreshDataSchema.client>;
+export declare const urlInspectionRefreshOperation: {
+    readonly visibility: 'public';
+    readonly errors: readonly ["invalid_request", "unauthorized", "auth_expired", "forbidden", "not_found", "entitlement_required", "stale_evidence", "rate_limited", "provider_unavailable", "conflict", "contract_violation", "internal_error"];
+    readonly errorResponse: import("./core.js").CompatibleResponseSchema<z.ZodObject<{
+        readonly error: z.ZodObject<{
+            code: z.ZodEnum<{
+                auth_expired: "auth_expired";
+                conflict: "conflict";
+                contract_violation: "contract_violation";
+                entitlement_required: "entitlement_required";
+                forbidden: "forbidden";
+                internal_error: "internal_error";
+                invalid_request: "invalid_request";
+                not_found: "not_found";
+                provider_unavailable: "provider_unavailable";
+                quota_exhausted: "quota_exhausted";
+                rate_limited: "rate_limited";
+                site_ambiguous: "site_ambiguous";
+                stale_evidence: "stale_evidence";
+                unauthorized: "unauthorized";
+            }>;
+            message: z.ZodString;
+            requestId: z.ZodString;
+            retryable: z.ZodBoolean;
+            details: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        }, z.core.$strict>;
+    }, z.core.$strip>, z.ZodObject<{
+        readonly error: z.ZodObject<{
+            code: z.ZodEnum<{
+                auth_expired: "auth_expired";
+                conflict: "conflict";
+                contract_violation: "contract_violation";
+                entitlement_required: "entitlement_required";
+                forbidden: "forbidden";
+                internal_error: "internal_error";
+                invalid_request: "invalid_request";
+                not_found: "not_found";
+                provider_unavailable: "provider_unavailable";
+                quota_exhausted: "quota_exhausted";
+                rate_limited: "rate_limited";
+                site_ambiguous: "site_ambiguous";
+                stale_evidence: "stale_evidence";
+                unauthorized: "unauthorized";
+            }>;
+            message: z.ZodString;
+            requestId: z.ZodString;
+            retryable: z.ZodBoolean;
+            details: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        }, z.core.$loose>;
+    }, z.core.$strip>>;
+    readonly policy: {
+        readonly rate: {
+            readonly name: 'public-v1-fixed-window';
+            readonly limit: 50;
+            readonly windowSeconds: 60;
+        };
+        readonly idempotency: {
+            readonly _tag: 'none';
+        };
+        readonly entitlement: null;
+        readonly meter: null;
+    };
+    readonly id: 'sites.search.indexing.inspection.refresh';
+    readonly method: 'POST';
+    readonly path: '/api/v1/sites/{siteId}/search/indexing/inspection';
+    readonly semantics: {
+        readonly kind: 'mutation';
+        readonly sideEffects: 'state';
+        readonly retry: 'never';
+        readonly readConsistency: null;
+    };
+    readonly auth: {
+        readonly credentials: readonly ["session", "api_token"];
+        readonly scopes: readonly ["sites:write"];
+        readonly minimumRole: 'member';
+        readonly ownership: 'site';
+    };
+    readonly request: {
+        readonly params: z.ZodObject<{
+            siteId: z.ZodString;
+        }, z.core.$strict>;
+        readonly query: null;
+        readonly headers: null;
+        readonly body: z.ZodObject<{
+            url: z.ZodString;
+        }, z.core.$strict>;
+    };
+    readonly responses: {
+        readonly 200: import("./core.js").CompatibleResponseSchema<z.ZodObject<{
+            data: z.ZodObject<{
+                siteId: z.ZodString;
+                rateLimit: z.ZodObject<{
+                    reserved: z.ZodNumber;
+                    remaining: z.ZodNumber;
+                    limit: z.ZodNumber;
+                }, z.core.$loose>;
+                results: z.ZodArray<z.ZodObject<{
+                    url: z.ZodString;
+                    verdict: z.ZodNullable<z.ZodString>;
+                    coverageState: z.ZodNullable<z.ZodString>;
+                    indexingState: z.ZodNullable<z.ZodString>;
+                    robotsTxtState: z.ZodNullable<z.ZodString>;
+                    pageFetchState: z.ZodNullable<z.ZodString>;
+                    lastCrawlTime: z.ZodNullable<z.ZodString>;
+                    crawlingUserAgent: z.ZodNullable<z.ZodString>;
+                    userCanonical: z.ZodNullable<z.ZodString>;
+                    googleCanonical: z.ZodNullable<z.ZodString>;
+                    sitemaps: z.ZodNullable<z.ZodString>;
+                    referringUrls: z.ZodNullable<z.ZodString>;
+                    mobileVerdict: z.ZodNullable<z.ZodString>;
+                    mobileIssues: z.ZodNullable<z.ZodString>;
+                    richResultsVerdict: z.ZodNullable<z.ZodString>;
+                    richResultsItems: z.ZodNullable<z.ZodString>;
+                    inspectionResultLink: z.ZodNullable<z.ZodString>;
+                }, z.core.$loose>>;
+                errors: z.ZodArray<z.ZodObject<{
+                    url: z.ZodString;
+                    error: z.ZodString;
+                }, z.core.$loose>>;
+                skipped: z.ZodArray<z.ZodObject<{
+                    url: z.ZodString;
+                    reason: z.ZodString;
+                }, z.core.$loose>>;
+                checkedAt: z.ZodISODateTime;
+            }, z.core.$strict>;
+            meta: z.ZodObject<{
+                requestId: z.ZodString;
+                version: z.ZodLiteral<"1.0">;
+            }, z.core.$strict>;
+        }, z.core.$strip>, z.ZodObject<{
+            data: z.ZodObject<{
+                siteId: z.ZodString;
+                rateLimit: z.ZodObject<{
+                    reserved: z.ZodNumber;
+                    remaining: z.ZodNumber;
+                    limit: z.ZodNumber;
+                }, z.core.$loose>;
+                results: z.ZodArray<z.ZodObject<{
+                    url: z.ZodString;
+                    verdict: z.ZodNullable<z.ZodString>;
+                    coverageState: z.ZodNullable<z.ZodString>;
+                    indexingState: z.ZodNullable<z.ZodString>;
+                    robotsTxtState: z.ZodNullable<z.ZodString>;
+                    pageFetchState: z.ZodNullable<z.ZodString>;
+                    lastCrawlTime: z.ZodNullable<z.ZodString>;
+                    crawlingUserAgent: z.ZodNullable<z.ZodString>;
+                    userCanonical: z.ZodNullable<z.ZodString>;
+                    googleCanonical: z.ZodNullable<z.ZodString>;
+                    sitemaps: z.ZodNullable<z.ZodString>;
+                    referringUrls: z.ZodNullable<z.ZodString>;
+                    mobileVerdict: z.ZodNullable<z.ZodString>;
+                    mobileIssues: z.ZodNullable<z.ZodString>;
+                    richResultsVerdict: z.ZodNullable<z.ZodString>;
+                    richResultsItems: z.ZodNullable<z.ZodString>;
+                    inspectionResultLink: z.ZodNullable<z.ZodString>;
+                }, z.core.$loose>>;
+                errors: z.ZodArray<z.ZodObject<{
+                    url: z.ZodString;
+                    error: z.ZodString;
+                }, z.core.$loose>>;
+                skipped: z.ZodArray<z.ZodObject<{
+                    url: z.ZodString;
+                    reason: z.ZodString;
+                }, z.core.$loose>>;
+                checkedAt: z.ZodISODateTime;
+            }, z.core.$loose>;
+            meta: z.ZodObject<{
+                requestId: z.ZodString;
+                version: z.ZodLiteral<"1.0">;
+            }, z.core.$loose>;
+        }, z.core.$strip>>;
+    };
+    readonly resources: {
+        readonly reads: readonly [{
+            readonly type: 'site.page';
+            readonly idFrom: 'params.siteId';
+        }];
+        readonly changes: readonly [{
+            readonly type: 'site.page';
+            readonly idFrom: 'params.siteId';
+        }];
+    };
+    readonly lifecycle: {
+        readonly introduced: '1.3.0';
+    };
+    readonly docs: {
+        readonly summary: 'Request a fresh URL Inspection';
+        readonly description: 'Requests Google URL Inspection through the Site connection. Uses inspection quota and retains the result. Errors and skipped URLs remain explicit.';
+        readonly tags: readonly ["Sites", "Search", "Indexing"];
+        readonly examples: readonly [{
+            readonly request: {
+                readonly params: {
+                    readonly siteId: 'site_01JXYZ';
+                };
+                readonly body: {
+                    readonly url: '/docs';
+                };
+            };
+            readonly response: {
+                readonly status: 200;
+                readonly body: {
+                    readonly data: {
+                        readonly siteId: 'site_01JXYZ';
+                        readonly checkedAt: '2026-10-05T00:00:00.000Z';
+                        readonly rateLimit: {
+                            readonly reserved: 1;
+                            readonly remaining: 9;
+                            readonly limit: 10;
+                        };
+                        readonly results: readonly [];
+                        readonly errors: readonly [{
+                            readonly url: 'https://example.com/docs';
+                            readonly error: 'Inspection failed';
+                        }];
+                        readonly skipped: readonly [];
+                    };
+                    readonly meta: {
+                        readonly requestId: 'req_01JXYZ';
+                        readonly version: '1.0';
+                    };
+                };
+            };
+        }];
+    };
+};
 export declare const indexCohortsQuerySchema: z.ZodObject<{
     limit: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
     minSectionPages: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
@@ -6687,6 +7073,231 @@ export declare const searchV1Registry: import("./core.js").PublicV1Registry<{
             }];
         };
     };
+    readonly refreshUrlInspection: {
+        readonly visibility: 'public';
+        readonly errors: readonly ["invalid_request", "unauthorized", "auth_expired", "forbidden", "not_found", "entitlement_required", "stale_evidence", "rate_limited", "provider_unavailable", "conflict", "contract_violation", "internal_error"];
+        readonly errorResponse: import("./core.js").CompatibleResponseSchema<z.ZodObject<{
+            readonly error: z.ZodObject<{
+                code: z.ZodEnum<{
+                    auth_expired: "auth_expired";
+                    conflict: "conflict";
+                    contract_violation: "contract_violation";
+                    entitlement_required: "entitlement_required";
+                    forbidden: "forbidden";
+                    internal_error: "internal_error";
+                    invalid_request: "invalid_request";
+                    not_found: "not_found";
+                    provider_unavailable: "provider_unavailable";
+                    quota_exhausted: "quota_exhausted";
+                    rate_limited: "rate_limited";
+                    site_ambiguous: "site_ambiguous";
+                    stale_evidence: "stale_evidence";
+                    unauthorized: "unauthorized";
+                }>;
+                message: z.ZodString;
+                requestId: z.ZodString;
+                retryable: z.ZodBoolean;
+                details: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+            }, z.core.$strict>;
+        }, z.core.$strip>, z.ZodObject<{
+            readonly error: z.ZodObject<{
+                code: z.ZodEnum<{
+                    auth_expired: "auth_expired";
+                    conflict: "conflict";
+                    contract_violation: "contract_violation";
+                    entitlement_required: "entitlement_required";
+                    forbidden: "forbidden";
+                    internal_error: "internal_error";
+                    invalid_request: "invalid_request";
+                    not_found: "not_found";
+                    provider_unavailable: "provider_unavailable";
+                    quota_exhausted: "quota_exhausted";
+                    rate_limited: "rate_limited";
+                    site_ambiguous: "site_ambiguous";
+                    stale_evidence: "stale_evidence";
+                    unauthorized: "unauthorized";
+                }>;
+                message: z.ZodString;
+                requestId: z.ZodString;
+                retryable: z.ZodBoolean;
+                details: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+            }, z.core.$loose>;
+        }, z.core.$strip>>;
+        readonly policy: {
+            readonly rate: {
+                readonly name: 'public-v1-fixed-window';
+                readonly limit: 50;
+                readonly windowSeconds: 60;
+            };
+            readonly idempotency: {
+                readonly _tag: 'none';
+            };
+            readonly entitlement: null;
+            readonly meter: null;
+        };
+        readonly id: 'sites.search.indexing.inspection.refresh';
+        readonly method: 'POST';
+        readonly path: '/api/v1/sites/{siteId}/search/indexing/inspection';
+        readonly semantics: {
+            readonly kind: 'mutation';
+            readonly sideEffects: 'state';
+            readonly retry: 'never';
+            readonly readConsistency: null;
+        };
+        readonly auth: {
+            readonly credentials: readonly ["session", "api_token"];
+            readonly scopes: readonly ["sites:write"];
+            readonly minimumRole: 'member';
+            readonly ownership: 'site';
+        };
+        readonly request: {
+            readonly params: z.ZodObject<{
+                siteId: z.ZodString;
+            }, z.core.$strict>;
+            readonly query: null;
+            readonly headers: null;
+            readonly body: z.ZodObject<{
+                url: z.ZodString;
+            }, z.core.$strict>;
+        };
+        readonly responses: {
+            readonly 200: import("./core.js").CompatibleResponseSchema<z.ZodObject<{
+                data: z.ZodObject<{
+                    siteId: z.ZodString;
+                    rateLimit: z.ZodObject<{
+                        reserved: z.ZodNumber;
+                        remaining: z.ZodNumber;
+                        limit: z.ZodNumber;
+                    }, z.core.$loose>;
+                    results: z.ZodArray<z.ZodObject<{
+                        url: z.ZodString;
+                        verdict: z.ZodNullable<z.ZodString>;
+                        coverageState: z.ZodNullable<z.ZodString>;
+                        indexingState: z.ZodNullable<z.ZodString>;
+                        robotsTxtState: z.ZodNullable<z.ZodString>;
+                        pageFetchState: z.ZodNullable<z.ZodString>;
+                        lastCrawlTime: z.ZodNullable<z.ZodString>;
+                        crawlingUserAgent: z.ZodNullable<z.ZodString>;
+                        userCanonical: z.ZodNullable<z.ZodString>;
+                        googleCanonical: z.ZodNullable<z.ZodString>;
+                        sitemaps: z.ZodNullable<z.ZodString>;
+                        referringUrls: z.ZodNullable<z.ZodString>;
+                        mobileVerdict: z.ZodNullable<z.ZodString>;
+                        mobileIssues: z.ZodNullable<z.ZodString>;
+                        richResultsVerdict: z.ZodNullable<z.ZodString>;
+                        richResultsItems: z.ZodNullable<z.ZodString>;
+                        inspectionResultLink: z.ZodNullable<z.ZodString>;
+                    }, z.core.$loose>>;
+                    errors: z.ZodArray<z.ZodObject<{
+                        url: z.ZodString;
+                        error: z.ZodString;
+                    }, z.core.$loose>>;
+                    skipped: z.ZodArray<z.ZodObject<{
+                        url: z.ZodString;
+                        reason: z.ZodString;
+                    }, z.core.$loose>>;
+                    checkedAt: z.ZodISODateTime;
+                }, z.core.$strict>;
+                meta: z.ZodObject<{
+                    requestId: z.ZodString;
+                    version: z.ZodLiteral<"1.0">;
+                }, z.core.$strict>;
+            }, z.core.$strip>, z.ZodObject<{
+                data: z.ZodObject<{
+                    siteId: z.ZodString;
+                    rateLimit: z.ZodObject<{
+                        reserved: z.ZodNumber;
+                        remaining: z.ZodNumber;
+                        limit: z.ZodNumber;
+                    }, z.core.$loose>;
+                    results: z.ZodArray<z.ZodObject<{
+                        url: z.ZodString;
+                        verdict: z.ZodNullable<z.ZodString>;
+                        coverageState: z.ZodNullable<z.ZodString>;
+                        indexingState: z.ZodNullable<z.ZodString>;
+                        robotsTxtState: z.ZodNullable<z.ZodString>;
+                        pageFetchState: z.ZodNullable<z.ZodString>;
+                        lastCrawlTime: z.ZodNullable<z.ZodString>;
+                        crawlingUserAgent: z.ZodNullable<z.ZodString>;
+                        userCanonical: z.ZodNullable<z.ZodString>;
+                        googleCanonical: z.ZodNullable<z.ZodString>;
+                        sitemaps: z.ZodNullable<z.ZodString>;
+                        referringUrls: z.ZodNullable<z.ZodString>;
+                        mobileVerdict: z.ZodNullable<z.ZodString>;
+                        mobileIssues: z.ZodNullable<z.ZodString>;
+                        richResultsVerdict: z.ZodNullable<z.ZodString>;
+                        richResultsItems: z.ZodNullable<z.ZodString>;
+                        inspectionResultLink: z.ZodNullable<z.ZodString>;
+                    }, z.core.$loose>>;
+                    errors: z.ZodArray<z.ZodObject<{
+                        url: z.ZodString;
+                        error: z.ZodString;
+                    }, z.core.$loose>>;
+                    skipped: z.ZodArray<z.ZodObject<{
+                        url: z.ZodString;
+                        reason: z.ZodString;
+                    }, z.core.$loose>>;
+                    checkedAt: z.ZodISODateTime;
+                }, z.core.$loose>;
+                meta: z.ZodObject<{
+                    requestId: z.ZodString;
+                    version: z.ZodLiteral<"1.0">;
+                }, z.core.$loose>;
+            }, z.core.$strip>>;
+        };
+        readonly resources: {
+            readonly reads: readonly [{
+                readonly type: 'site.page';
+                readonly idFrom: 'params.siteId';
+            }];
+            readonly changes: readonly [{
+                readonly type: 'site.page';
+                readonly idFrom: 'params.siteId';
+            }];
+        };
+        readonly lifecycle: {
+            readonly introduced: '1.3.0';
+        };
+        readonly docs: {
+            readonly summary: 'Request a fresh URL Inspection';
+            readonly description: 'Requests Google URL Inspection through the Site connection. Uses inspection quota and retains the result. Errors and skipped URLs remain explicit.';
+            readonly tags: readonly ["Sites", "Search", "Indexing"];
+            readonly examples: readonly [{
+                readonly request: {
+                    readonly params: {
+                        readonly siteId: 'site_01JXYZ';
+                    };
+                    readonly body: {
+                        readonly url: '/docs';
+                    };
+                };
+                readonly response: {
+                    readonly status: 200;
+                    readonly body: {
+                        readonly data: {
+                            readonly siteId: 'site_01JXYZ';
+                            readonly checkedAt: '2026-10-05T00:00:00.000Z';
+                            readonly rateLimit: {
+                                readonly reserved: 1;
+                                readonly remaining: 9;
+                                readonly limit: 10;
+                            };
+                            readonly results: readonly [];
+                            readonly errors: readonly [{
+                                readonly url: 'https://example.com/docs';
+                                readonly error: 'Inspection failed';
+                            }];
+                            readonly skipped: readonly [];
+                        };
+                        readonly meta: {
+                            readonly requestId: 'req_01JXYZ';
+                            readonly version: '1.0';
+                        };
+                    };
+                };
+            }];
+        };
+    };
     readonly readIndexingCohorts: {
         readonly id: 'sites.search.indexing.cohorts.read';
         readonly method: 'GET';

package/dist/v1/gsc.js

@@ -1,4 +1,4 @@
-import { canonicalDifferenceKindSchema, gscdumpAnalysisPresetSchema, gscdumpIndexingTransitionFieldSchema, gscdumpTotalsSchema, indexingIssueSchema, } from '@gscdump/contracts';
+import { canonicalDifferenceKindSchema, gscdumpAnalysisPresetSchema, gscdumpIndexingTransitionFieldSchema, gscdumpTotalsSchema, indexingInspectResponseSchema, indexingIssueSchema, } from '@gscdump/contracts';
 import { z as schema } from 'zod';
 import { defineOperation, defineRegistry, defineResponseObject, defineSuccessEnvelope, publicV1ErrorEnvelope, publicV1PageSchema, publicV1StandardRatePolicy, } from './core.js';
 export const searchConsoleSiteParamsSchema = schema.strictObject({
@@ -620,6 +620,30 @@ export const urlInspectionReadOperation = defineOperation({
         examples: [{ request: { params: { siteId: 'site_01JXYZ' }, query: { url: '/docs' } }, response: { status: 200, body: { data: { _tag: 'no-inspection-data', requestedUrl: 'https://example.com/docs' }, meta: { requestId: 'req_01JXYZ', version: '1.0' } } } }],
     },
 });
+export const urlInspectionRefreshBodySchema = schema.strictObject({ url: pageUrlSchema });
+export const urlInspectionRefreshDataSchema = {
+    producer: indexingInspectResponseSchema.extend({ checkedAt: schema.iso.datetime() }).strict(),
+    client: indexingInspectResponseSchema.extend({ checkedAt: schema.iso.datetime() }).loose(),
+};
+export const urlInspectionRefreshResponseSchema = defineSuccessEnvelope(urlInspectionRefreshDataSchema);
+export const urlInspectionRefreshOperation = defineOperation({
+    ...common,
+    id: 'sites.search.indexing.inspection.refresh',
+    method: 'POST',
+    path: '/api/v1/sites/{siteId}/search/indexing/inspection',
+    semantics: { kind: 'mutation', sideEffects: 'state', retry: 'never', readConsistency: null },
+    auth: { credentials: ['session', 'api_token'], scopes: ['sites:write'], minimumRole: 'member', ownership: 'site' },
+    request: { params: searchConsoleSiteParamsSchema, query: null, headers: null, body: urlInspectionRefreshBodySchema },
+    responses: { 200: urlInspectionRefreshResponseSchema },
+    resources: { reads: [{ type: 'site.page', idFrom: 'params.siteId' }], changes: [{ type: 'site.page', idFrom: 'params.siteId' }] },
+    lifecycle: { introduced: '1.3.0' },
+    docs: {
+        summary: 'Request a fresh URL Inspection',
+        description: 'Requests Google URL Inspection through the Site connection. Uses inspection quota and retains the result. Errors and skipped URLs remain explicit.',
+        tags: ['Sites', 'Search', 'Indexing'],
+        examples: [{ request: { params: { siteId: 'site_01JXYZ' }, body: { url: '/docs' } }, response: { status: 200, body: { data: { siteId: 'site_01JXYZ', checkedAt: '2026-10-05T00:00:00.000Z', rateLimit: { reserved: 1, remaining: 9, limit: 10 }, results: [], errors: [{ url: 'https://example.com/docs', error: 'Inspection failed' }], skipped: [] }, meta: { requestId: 'req_01JXYZ', version: '1.0' } } } }],
+    },
+});
 export const indexCohortsQuerySchema = schema.strictObject({
     limit: schema.coerce.number().int().min(1).max(50).default(12),
     minSectionPages: schema.coerce.number().int().min(1).max(500).default(5),
@@ -816,6 +840,7 @@ export const searchV1Registry = defineRegistry({
         readIndexingDiagnostics: indexingDiagnosticsReadOperation,
         readIndexingHistory: indexingHistoryReadOperation,
         readUrlInspection: urlInspectionReadOperation,
+        refreshUrlInspection: urlInspectionRefreshOperation,
         readIndexingCohorts: indexCohortsReadOperation,
     },
 });