Skip to main content
POST
/
api
/
v1
/
agent
/
validate-tool
Validate Tool Call
curl --request POST \
  --url https://api.promptguard.dev/api/v1/agent/validate-tool \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "agent_id": "<string>",
  "tool_name": "<string>",
  "arguments": {},
  "session_id": "<string>"
}
'
{
  "allowed": true,
  "risk_score": 123,
  "risk_level": "<string>",
  "reason": "<string>",
  "warnings": [],
  "blocked_reasons": []
}

Documentation Index

Fetch the complete documentation index at: https://docs.promptguard.co/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
X-API-Key
string
header
required

PromptGuard API key for developer endpoints. Keys start with pg_live_ and are created in the dashboard.

Headers

​
x-api-key
string | null

Body

application/json

Request to validate a tool call

​
agent_id
string
required
​
tool_name
string
required
​
arguments
Arguments · object
required
​
session_id
string | null

Response

Successful Response

Response from tool call validation

​
allowed
boolean
required
​
risk_score
number
required
​
risk_level
string
required
​
reason
string
required
​
warnings
string[]
​
blocked_reasons
string[]