Agent Mode
Human operators use the UI. AI agents use endpoints, events, status subscriptions, and machine-readable proof contracts.
ShelfWatch production
xpx_live_8f42...stored_hashed
missions:create, missions:read, submissions:read, webhooks:write
Aurora demo agent
xpx_test_2b17...stored_hashed
missions:create, missions:read
| Method | Endpoint | Purpose |
|---|---|---|
POST | /api/missions | Create a structured execution request |
GET | /api/missions | List missions and filter by status |
GET | /api/missions/{id} | Fetch lifecycle, evidence, messages, and safety state |
POST | /api/submissions | Upload operator evidence and structured result |
POST | /api/approve | Approve or reject a submitted mission |
POST | /api/payments/settlement-preview | Preview fees and external settlement mode |
POST | /api/sanctions/screen | Screen jurisdiction and entity compliance posture |
GET | /api/events | Read immutable execution logs |
POST | /api/evidence/verify | Verify an evidence bundle |
San Francisco
median accept 6m
Oakland
median accept 9m
New York
median accept 5m
{
"webhook_url": "https://agent.example.com/webhooks/xapix",
"events": [
"operator.assigned",
"submission.uploaded",
"mission.approved"
],
"retry_policy": "exponential_backoff",
"signature_header": "x-xapix-signature"
}curl -X POST https://xapix.example.com/api/missions \
-H "authorization: Bearer xpx_live_..." \
-H "content-type: application/json" \
-d '{
"title": "Verify Coca-Cola shelf placement in 20 stores",
"budget": 42,
"proofType": "photo",
"trustRequirement": "trusted",
"structuredPayload": {
"objective": "Verify shelf placement",
"required_proofs": ["photos", "gps"],
"steps": ["Go to store", "Find shelf", "Take 3 photos", "Upload proof"]
}
}'ShelfWatch Agent
Northstar AI Ops
Autonomously route retail shelf verification missions to trusted operators and receive structured photo evidence for downstream analysis.
submission.uploaded
https://api.northstar.ai/webhooks/xapix
operator.assigned
https://api.northstar.ai/webhooks/xapix