Skip to navigation
Code Examples

cURL Examples

cURL Examples

Common GovernanceAI API calls using cURL.

Evaluate Guardrails

curl -X POST https://api.governanceai.com/v1/guardrails/evaluate \
  -H "Authorization: Bearer $GOVERNANCEAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "messages": [
      {
        "role": "user",
        "content": "What is the capital of France?"
      }
    ],
    "context": {
      "org_id": "org_123",
      "user_id": "user_456"
    }
  }'

Create Guardrail

curl -X POST https://api.governanceai.com/v1/guardrails \
  -H "Authorization: Bearer $GOVERNANCEAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Block PII",
    "rule_type": "block_pii",
    "severity": "high"
  }'

Run Scan

curl -X POST https://api.governanceai.com/v1/scans \
  -H "Authorization: Bearer $GOVERNANCEAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "scan_type": "code_scan",
    "repositories": ["repo_123"]
  }'

Get Audit Logs

curl -H "Authorization: Bearer $GOVERNANCEAI_API_KEY" \
  'https://api.governanceai.com/v1/audit/logs?start_date=2024-01-01'

Generate Report

curl -X POST https://api.governanceai.com/v1/reports/generate \
  -H "Authorization: Bearer $GOVERNANCEAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "compliance",
    "frameworks": ["SOC2"],
    "format": "pdf"
  }' \
  --output report.pdf

Tips

  • Use -H for headers
  • Use -d for JSON body
  • Set Content-Type: application/json
  • Always include Authorization header
  • Use $GOVERNANCEAI_API_KEY environment variable
  • Use --output to save response to file

Next Steps