Skip to main content

AI Guard API Reference

Base URL

ai-guard.<csp>.<region>.pangea.cloud

post/v1beta/text/guard
curl -sSLX POST 'https://ai-guard.aws.us.pangea.cloud/v1beta/text/guard' \
-H 'Authorization: Bearer <your_token>' \
-H 'Content-Type: application/json' \
-d '{}'

Response


Text Guard for scanning LLM inputs and outputs

POST
https://ai-guard.aws.us.pangea.cloud/v1beta/text/guard

Analyze and redact text to avoid manipulation of the model, addition of malicious content, and other undesirable data transfers.

fields

string

Text to be scanned by AI Guard for PII, sensitive data, malicious content, and other data types defined by the configuration. Supports processing up to 10KB of text.

string
(default: "pangea_prompt_guard")

Recipe key of a configuration of data types and settings defined in the Pangea User Console. It specifies the rules that are to be applied to the text, such as defang malicious URLs.

boolean
(default: false)

Setting this value to true will provide a detailed analysis of the text data

object
object
string
object

Pangea standard response schema

object
string

Text that was scanned for redaction

string

Recipe used to scan the text

object

Result of the recipe analyzing and redacting the text input

integer

Number of prompt injections found in the analysis

integer

Number of texts found to be malicious in the analysis based on the recipe settings

integer

Number of artifacts that matched rules in the analysis

object

List of possible security issues discovered in the text

integer

Number of text strings that match redaction rules from the recipe

integer

Number of malicious IP addresses identified

integer

Number of malicious domains identified

integer

Number of malicious URLs identified

integer

Number of compromised email addresses identified

array<object>

List of matches to the recipe's redaction settings, including data type, matched substring, start and end indices, defang status, and verdict as determined by the recipe's redaction rules

string

Redaction rule applied, e.g. EMAIL_ADDRESS

string

Substring that matches the redaction rule

integer

Starting index of the matched substring

integer

Ending index of the matched substring

boolean

Boolean indicating whether the substring was defanged

string

The verdict, given by the Pangea service, for the indicator

string

A unique identifier assigned to each request made to the API. It is used to track and identify a specific request and its associated data. The request_id can be helpful for troubleshooting, auditing, and tracing the flow of requests within the system. It allows users to reference and retrieve information related to a particular request, such as the response, parameters, and raw data associated with that specific request.

"request_id":"prq_x6fdiizbon6j3bsdvnpmwxsz2aan7fqd"
string

The timestamp indicates the exact moment when a request is made to the API. It represents the date and time at which the request was initiated by the client. The request_time is useful for tracking and analyzing the timing of requests, measuring response times, and monitoring performance metrics. It allows users to determine the duration between the request initiation and the corresponding response, aiding in the assessment of API performance and latency.

"request_time":"2022-09-21T17:24:33.105Z"
string

Duration it takes for the API to process a request and generate a response. It represents the elapsed time from when the request is received by the API to when the corresponding response is returned to the client.

"response_time":"2022-09-21T17:24:34.007Z"
string

It represents the status or outcome of the API request made for IP information. It indicates the current state or condition of the request and provides information on the success or failure of the request.

"status":"success"
string

Provides a concise and brief overview of the purpose or primary objective of the API endpoint. It serves as a high-level summary or description of the functionality or feature offered by the endpoint.

Status Codes
StatusStatus CodeDescription
NoProviderConfigured400

Provider for intelligence services used by ai-guard is not configured

RecipeNotExist400

Recipe does not exist in the ai-guard configuration

Was this article helpful?

Contact us