PG
ProcessGhost API DOCS
DEVELOPER REFERENCE // API VERSION 1.4-LTS

ProcessGhost Developer Hub

Welcome to the ProcessGhost developer documentation. Integrate autonomous multi-agent AI execution, real-time ledger reconciliation, and eBPF self-healing probes into your applications using our clean REST APIs and native SDKs.

2-Minute Quickstart

ProcessGhost exposes standard REST and streaming WebSocket endpoints hosted globally across AWS edge locations. You can trigger an autonomous agent execution in just a single API call.

cURL Quickstart Request 
curl -X POST https://api.processghost.org/v1/agents/execute \
  -H "Authorization: Bearer pg_live_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "agent": "reconciliation-v1",
    "model": "anthropic.claude-3-5-sonnet-20241022-v2:0",
    "prompt": "Reconcile payment tx_9921 against invoice inv_4412",
    "stream": false
  }'

Official SDK Installation

We provide official, production-ready SDKs with complete TypeScript definitions and Python async support.

NODE.JS / TYPESCRIPT
npm install @processghost/sdk
PYTHON 3.9+
pip install processghost
Python SDK Example (main.py) 
from processghost import ProcessGhostClient

client = ProcessGhostClient(api_key="pg_live_your_key")

response = client.agents.execute(
    agent="reconciliation-v1",
    payload={
        "invoice_id": "INV-2026-901",
        "ledger_currency": "USD",
        "settlement_amount": 14250.00
    }
)

print("Status:", response.status)
print("Adjusted Ledger Entry:", response.reconciliation_entry)

Authentication & API Keys

All API requests must contain a valid bearer token in the Authorization HTTP header. API keys come in two modes:

TEST MODE (Sandbox)
Prefix: pg_test_...
Mock executions with zero billing impact.
LIVE PRODUCTION
Prefix: pg_live_...
Full Amazon Bedrock live inference & ledger commits.
POST /v1/agents/execute

Dispatches an autonomous agent task into the ProcessGhost execution cluster. Routes through Amazon Bedrock foundation models with sub-millisecond graph validation.

REQUEST PARAMETERS:
agent *string
Registered agent template (e.g. reconciliation-v1)
model string
Target Bedrock model (default: Claude 3.5 Sonnet)
stream boolean
Stream token responses via SSE (default: false)