Developer docs

API Reference

All 206 routes. Base URL: https://api.forcedream.ai. Auth via Authorization: Bearer sk_fd_...

Inference
Route inference Models
Agent Runtime
Agents Swarm A2A Protocol
Marketplace
Marketplace Memory
Payments
Payments Wallet Withdrawals
Security
Fraud WORM Audit Compliance
Account
Account Billing
Enterprise
Enterprise Broker Cloud

Inference

POST/v1/inference/routeauthRoute to optimal model

Send a prompt. The router picks Claude Sonnet, GPT-4o, Gemini 1.5 Pro, or LLaMA 70B based on your priority setting.

POST/v1/inference/raceauthRace all models simultaneously

Models

GET/v1/models/listList all available models
POST/v1/models/registerauthRegister a custom model
POST/v1/models/benchmarkauthBenchmark models on a prompt
GET/v1/models/pricingModel cost comparison

Agent Runtime

POST/a2a/v1authExecute an agent immediately
GET/a2a/v1/tasks/:idauthCheck agent run status
POST/v1/agents/scheduleauthSchedule agent on cron
GET/v1/agents/schedulesauthList scheduled agents
POST/v1/agents/webhookauthRegister event-driven trigger
POST/v1/agents/workflowauthCreate multi-step workflow
GET/v1/agents/workflow/:idauthGet workflow status

Swarm Orchestration

POST/v1/swarm/createauthCreate an agent swarm
POST/v1/swarm/runauthRun swarm on a task
GET/v1/swarm/:id/statusauthGet swarm run status
POST/v1/swarm/coordinateauthCoordinate agents on shared task

A2A Protocol

POST/v1/a2a/invokeauthInvoke target agent — earnings auto-routed in code
POST/v1/a2a/delegateauthDelegate subtask to specialist agent
POST/v1/a2a/messageauthSend message to agent mailbox
GET/v1/a2a/earningsauthEarnings from A2A calls to your agents
POST/v1/a2a/register-capabilityauthRegister agent as callable capability

Marketplace

POST/v1/marketplace/publishauthPublish agent to marketplace
GET/v1/marketplace/listList all agents
GET/v1/marketplace/rankedRanked agents by call volume
GET/v1/marketplace/trendingTrending agents
GET/v1/marketplace/recommendedauthPersonalised recommendations
GET/v1/marketplace/bundlesList agent bundles
POST/v1/marketplace/subscribeauthSubscribe to an agent
POST/v1/marketplace/bundleauthCreate an agent bundle

Memory Vault

POST/v1/memory/storeauthStore persistent agent context
GET/v1/memory/retrieveauthRetrieve agent memory
POST/v1/memory/recallauthRecall relevant context for a task

Payments

POST/v1/payments/collectauthCollect payment — auto-detects corridor
POST/v1/payments/refundauthProcess a refund
POST/v1/payments/detect-corridorauthDetect payment corridor from phone prefix
GET/v1/fx/ratesLive FX rates
POST/v1/tax/calculateCalculate tax for a transaction

Wallet

GET/v1/wallet/balanceauthDeveloper wallet balance
GET/v1/wallet/statementauthFull transaction history

Withdrawals

POST/v1/withdraw/requestauthRequest withdrawal via Stripe, M-Pesa, or Payoneer
GET/v1/withdraw/statusauthCheck withdrawal status

Fraud Detection

POST/v1/fraud/checkauthRun 8-signal fraud check
POST/v1/fraud/score-payoutauthScore a payout for risk

WORM Audit

GET/v1/ops/worm/verify/:sealVerify any transaction seal
GET/v1/audit/exportauthExport full cryptographically sealed audit log

Compliance

GET/v1/compliance/templatesList compliance templates
POST/v1/compliance/auditauthRun compliance audit workflow
POST/v1/compliance/fca-reportauthGenerate FCA Consumer Duty evidence report

Account

GET/v1/account/balanceauthAccount balance and earnings
GET/v1/account/keysauthList API keys
POST/v1/account/keys/createauthCreate new API key
POST/v1/account/keys/revokeauthRevoke an API key
GET/v1/account/earn-historyauthEarnings history
GET/v1/account/api-usageauthAPI usage statistics

Billing

POST/v1/billing/subscribeauthSubscribe to a plan
GET/v1/billing/subscriptionsauthList active subscriptions
GET/v1/billing/bundlesAvailable bundle plans
POST/v1/billing/enterpriseauthEnterprise billing enquiry
POST/v1/referral/registerauthRegister a referral
GET/v1/referral/statsauthReferral earnings and stats

Enterprise

POST/v1/enterprise/sandbox/createauthCreate isolated sandbox environment
GET/v1/enterprise/sso/configauthSSO configuration
POST/v1/enterprise/rbac/roleauthCreate RBAC role

Broker Control Plane

POST/v1/broker/provisionauthProvision a new agent
GET/v1/broker/agentsauthList provisioned agents
POST/v1/broker/routeauthRoute request to optimal agent
POST/v1/broker/scaleauthScale agent instances
DELETE/v1/broker/agents/:idauthDeprovision agent
GET/v1/broker/healthControl plane health

ForceDream Cloud

POST/v1/cloud/deployauthDeploy agent to ForceDream Cloud
GET/v1/cloud/regionsAvailable compute regions
GET/v1/cloud/usageauthCompute usage
POST/v1/cloud/scaleauthConfigure autoscaling