Merge pull request #1055 from sarette/docs-8876-scan-api-hotfix

Docs 8876 scan api hotfix

Author: sra-hub

openapi-specs/prisma-airs/scan/ScanService_Oct2025.yaml

@@ -385,10 +385,21 @@ components:
           description: AI security profile name used for scanning
         category:
           type: string
-          description: Category of the scanned content verdicts such as "malicious" or "benign"
+          description: Category of the scanned content verdicts such as "malicious", "benign", "error" or "timeout"
         action:
           type: string
           description: The action is set to "block" or "allow" based on AI security profile used for scanning
+        timeout:
+          type: boolean
+          description: Indicates whether any detection service timed out during scanning
+        error:
+          type: boolean
+          description: Indicates whether any detection service encountered an error during scanning
+        errors:
+          type: array
+          description: List of detection service errors or timeouts
+          items:
+            $ref: "#/components/schemas/ContentErrors"
         prompt_detected:
           $ref: "#/components/schemas/PromptDetected"
         response_detected:
@@ -416,6 +427,48 @@ components:
         - scan_id
         - category
         - action
+        - timeout
+        - error
+        - errors
+
+    ContentErrors:
+      type: object
+      description: Errors information for prompt and response detection services
+      properties:
+        content_type:
+          $ref: "#/components/schemas/ContentErrorType"
+        feature:
+          $ref: "#/components/schemas/DetectionServiceName"
+        status:
+          $ref: "#/components/schemas/ErrorStatus"
+
+    ContentErrorType:
+      type: string
+      description: Type of content that encountered an error
+      enum:
+        - prompt
+        - response
+
+    ErrorStatus:
+      type: string
+      description: Status indicating error or timeout
+      enum:
+        - error
+        - timeout
+
+    DetectionServiceName:
+      type: string
+      description: Name of detection service
+      enum:
+        - dlp
+        - injection
+        - url_cats
+        - toxic_content
+        - malicious_code
+        - agent
+        - topic_violation
+        - db_security
+        - ungrounded
 
     PromptDetected:
       type: object

products/prisma-airs/api/airuntimesecurity/airuntimesecurityapi.md

@@ -1,15 +1,15 @@
 ---
 id: airuntimesecurityapi
-title: "Prisma AIRS AI Runtime API Intercept"
-sidebar_label: "Prisma AIRS AI Runtime API Intercept"
+title: "Prisma AIRS AI Runtime API"
+sidebar_label: "Prisma AIRS AI Runtime API"
 keywords:
   - AIRS
   - Reference
   - Cloud
   - API
 ---
 
-**Prisma AIRS AI Runtime API intercept** is a threat detection service designed to secure AI applications. It helps discover and protect applications using REST APIs by embedding Security-as-Code directly into your source code.
+**Prisma AIRS AI Runtime API** is a threat detection service designed to secure AI applications. It helps discover and protect applications using REST APIs by embedding Security-as-Code directly into your source code.
 
 The API intercept consists of two main API categories:
 
@@ -23,7 +23,7 @@ Both scan and management APIs support two authentication types:
 - **API key-based**: Use the `x-pan-token` header: `-H 'x-pan-token: <x-pan-token>'`.
 - **OAuth 2.0-based token (RBAC)**: Use the `Authorization` header with a bearer token: `-H 'Authorization: Bearer <token>'`.
 
-For licensing, onboarding, activation, and to obtain the API authentication key and profile name, refer to the [Prisma AIRS AI Runtime API intecept](https://docs.paloaltonetworks.com/ai-runtime-security/activation-and-onboarding/ai-runtime-security-api-intercept-overview) administration documentation.
+For licensing, onboarding, activation, and to obtain the API authentication key and profile name, refer to the [Prisma AIRS AI Runtime API](https://docs.paloaltonetworks.com/ai-runtime-security/activation-and-onboarding/ai-runtime-security-api-intercept-overview) administration documentation.
 
 ## Scan API Endpoints
 
@@ -32,11 +32,12 @@ The following are the API endpoints based on the regions you selected while crea
 - US: https://service.api.aisecurity.paloaltonetworks.com 
 - EU (Germany): https://service-de.api.aisecurity.paloaltonetworks.com
 - IN: https://service-in.api.aisecurity.paloaltonetworks.com
+- SG: https://service-sg.api.aisecurity.paloaltonetworks.com
 
 ## Prerequisites
 
 1. Create and associate a [deployment profile](https://docs.paloaltonetworks.com/ai-runtime-security/activation-and-onboarding/ai-runtime-security-api-intercept-overview/ai-deployment-profile-airs-api-intercept) for Prisma AIRS AI Runtime API intercept in your Customer Support Portal.
-2. [Onboard Prisma AIRS AI Runtime API intercept](https://docs.paloaltonetworks.com/ai-runtime-security/activation-and-onboarding/ai-runtime-security-api-intercept-overview/onboard-api-runtime-security-api-intercept-in-scm) in Strata Cloud Manager.
+2. [Onboard Prisma AIRS AI Runtime API](https://docs.paloaltonetworks.com/ai-runtime-security/activation-and-onboarding/ai-runtime-security-api-intercept-overview/onboard-api-runtime-security-api-intercept-in-scm) in Strata Cloud Manager.
 3. [Manage applications, API keys, security profiles, and custom topics](https://docs.paloaltonetworks.com/ai-runtime-security/administration/prevent-network-security-threats/airs-apirs-manage-api-keys-profile-apps) in Strata Cloud Manager.
 
 ## Requirements for API Usage
@@ -50,7 +51,7 @@ Specify this profile name or the profile ID in the API request payload in the `a
 You can manage API keys and AI security profiles in Strata Cloud Manager.
 
 1. Log in to [Strata Cloud Manager](http://stratacloudmanager.paloaltonetworks.com/).
-2. Navigate to **Insights > Prisma AIRS > Prisma AIRS AI Runtime: API Intercept**.
+2. Navigate to **AI Security > API Applications**.
 3. In the top right corner, click:
 
 - **Manage > API Keys** to copy, regenerate, or rotate the API key token.
@@ -66,7 +67,7 @@ For complete details, refer to adminstration guide for the section on how to "ma
 - 2 MB maximum payload size per synchronous scan request - Limited to a maximum of 100 URLs per request.
 - 5 MB maximum payload size per asynchronous scan request - Limited to a maximum of 100 URLs per request.
 - Asynchronous requests are limited to a maximum of 25 batched requests.
-- The following limitations apply to contextual grounding:
+- The following limitations apply to the contextual grounding detector:
 
   - **Context**: supports a maximum of 100,000 characters
   - **Prompt**: supports a maximum of 10,000 characters