Sutra.teamSUTRA

Developer Documentation

Everything you need to integrate with the Sutra.team platform.

Full API docs coming with Phase 2 launch

API Reference

Core endpoints for council deliberation, persona management, memory, and differentiation

MethodEndpoint
POST/v1/council/deliberate
POST/v1/council/deliberate/stream
GET/v1/council/{id}/perspectives
POST/v1/persona/create
PUT/v1/persona/{id}
GET/v1/persona/{id}
POST/v1/persona/{id}/chat
GET/v1/memory/{persona_id}/report
POST/v1/memory/{persona_id}/import
GET/v1/differentiation/{id}/score
POST/v1/knowledge/{id}/ingest

Connect API

Real-time communication endpoints for video, voice, and phone sessions

MethodEndpoint
POST/v1/connect/room/create
POST/v1/connect/token
POST/v1/connect/agents/dispatch
GET/v1/connect/room/{id}/status
POST/v1/connect/sip/trunk
GET/v1/connect/session/{id}/transcript

LiveKit Integration

Built on LiveKit for WebRTC video/voice and SIP phone bridging. Custom frontends can use the LiveKit SDK directly.

Agent Dispatch

Council agents join rooms as LiveKit participants. Pipeline: STT (Deepgram) → LLM (Claude) → TTS (Cartesia).

SIP / Phone

Inbound calls via SIP trunk. IVR routing, DTMF selection, PIN authentication. Same agent code for all modalities.

Persona Definition File (PDF)

Every persona is defined by four blocks

Identity Block

  • persona_id (UUID)
  • name
  • designation
  • origin_narrative
  • creator_id
  • tagline
  • version (SemVer)
  • visibility (private | unlisted | public | enterprise)

Voice Parameters

  • tone_descriptors (string[])
  • opening_patterns (templates)
  • closing_signature
  • avoidance_patterns
  • platform_adaptations
  • vocabulary_preferences
  • formality_range (0.0–1.0)

Value Framework

  • primary_framework
  • secondary_frameworks
  • constitutional_refs
  • principle_hierarchy (ordered)
  • uncertainty_protocol
  • decision_audit_log

Behavioral Constraints

  • hardcoded_constraints (absolute)
  • softcoded_defaults (overridable)
  • escalation_protocols
  • boundary_definitions

Authentication

Multiple auth methods for different use cases

OAuth 2.0 / JWT

Standard token-based authentication for web and mobile applications

Web apps, mobile apps

API Keys

Simple key-based authentication for programmatic access and server-to-server

Backend integrations, scripts

Enterprise SSO

SAML-based single sign-on for enterprise deployments

Enterprise plan only

Roles & Permissions

Role-based access control for persona and council operations

Creator

Full control over persona definition, knowledge base, and settings

Operator

Deploy and manage personas without editing definitions

User

Interact with personas and submit council deliberations

Viewer

Read-only access to differentiation scores and public data