Developer Preview

Everything you need to integrate the ROS.

This is the Trussi Intelligence developer preview — the architecture, endpoints, and integration patterns we're building. Design partner access is available now.

Request API Access Jump to quickstart

Get started

Up and running in minutes

Request design partner access

Submit an access request. Our team will reach out to discuss your integration use case and provision credentials for design partners.

Request Access

Authenticate your first call

Pass your API key in the Authorization header. All endpoints use HTTPS. OAuth 2.0 is available for production deployments.

Auth reference

Hit the sandbox

Design partners receive access to a sandbox environment with synthetic CRM data. Test the intelligence endpoints before connecting production data.

Sandbox guide

Go live

Swap your sandbox base URL for the production endpoint and deploy. Our team works closely with design partners through the initial integration.

Deployment checklist

Your first API call

Score a pipeline opportunity in under 10 lines of code.

Request

# Authenticate and score a deal
curl -X POST https://api.trussiintelligence.com/v1/pipeline/score \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "opportunity_id": "opp_abc123",
    "stage": "Proposal",
    "amount": 85000,
    "days_in_stage": 12,
    "last_activity_days": 3
  }'

Response 200● 142ms

{
  "opportunity_id": "opp_abc123",
  "score": 74,
  "health": "healthy",
  "close_probability": 0.68,
  "risk_flags": [],
  "recommended_action": "Schedule executive sponsor call"
}

Auth

Authentication

All API requests require authentication. Two methods are supported depending on your deployment context.

API Key (recommended for server-to-server)Pass your key in the Authorization header: Authorization: Bearer YOUR_API_KEY. Keys are scoped per environment (sandbox / production) and per API.

OAuth 2.0 (recommended for production)Use the client credentials flow for production deployments. Exchange your client_id and client_secret for a short-lived access token at /v1/auth/token.

IP allowlistingEnterprise accounts can restrict API access to specific IP ranges. Configure allowlists in your account dashboard or contact your account manager.

Sandbox

Sandbox environment

Design partner accounts include access to a sandbox environment pre-loaded with synthetic CRM data for integration testing.

Base URLhttps://sandbox.api.trussiintelligence.com — all endpoints are identical to production. Swap to https://api.trussiintelligence.com when going live.

Synthetic dataThe sandbox includes realistic CRM data across multiple industries and deal sizes, designed to exercise all intelligence endpoints.

Rate limitsSandbox rate limits are set to 1,000 requests/hour. Production limits are configured per your license tier.

Errors

Error handling

All errors return a consistent JSON envelope with a machine-readable code and a human-readable message.

400 Bad RequestMissing or invalid request parameters. Check the errors array in the response body for field-level detail.

401 UnauthorizedInvalid or expired API key. Regenerate your key in the dashboard or refresh your OAuth token.

429 Too Many RequestsRate limit exceeded. The Retry-After header indicates when you can resume. Implement exponential backoff for production resilience.

500 Internal Server ErrorUnexpected server error. These are rare and automatically alerted to our on-call team. Retry with exponential backoff.

Deployment

Production deployment checklist

Before going live, verify each item in this checklist with your engineering and RevOps teams.

Rotate to production credentialsReplace sandbox API keys with production keys. Never commit credentials to source control — use environment variables or a secrets manager.

Verify base URLConfirm all requests point to https://api.trussiintelligence.com. Sandbox and production are isolated — data does not transfer between environments.

Implement retry logicAdd exponential backoff with jitter for 429 and 5xx responses. We recommend a maximum of 3 retries with a base delay of 500ms.

Set up monitoringConfigure alerts on response time and error rate in your observability stack. Status page and uptime monitoring coming soon.

SDKs & libraries

Official client libraries

PythonPlanned

trussi-intelligenceComing Soon

pip install trussi-intelligence

Node.jsPlanned

@trussi/intelligenceComing Soon

npm install @trussi/intelligence

GoPlanned

github.com/trussi/intelligence-goComing Soon

go get github.com/trussi/intelligence-go

Resources

More ways to get help

Reference

API Reference

Full endpoint reference with request/response schemas, parameter descriptions, and example payloads for every ROS API.

Coming Soon

Postman Collection

A Postman collection for interactive endpoint exploration is planned for design partner release. Contact us to request early access.

Coming Soon

OpenAPI Spec

An OpenAPI 3.1 specification for client code generation and API gateway integration is in development for design partners.

Guides

Integration guides

Step-by-step guides for connecting the ROS APIs to Salesforce, HubSpot, Outreach, Salesloft, Snowflake, and Databricks.

Updates

Changelog

Every API version update, new endpoint, deprecation notice, and breaking change — documented and dated.

Support

Developer support

Design partners receive direct engineering support. Contact us to discuss your integration and get dedicated technical assistance.

Ready to start building?

Request design partner access and work directly with our team to integrate the Revenue Operating System.

Request API Access Talk to Sales