Skip to main content

Version History

This document provides a comprehensive history of all RiverGen API documentation versions, detailing what was included in each release.

Version 1.0.1 (Latest) - Current​

Release Date: January 2, 2026
Status: Latest / Current

Overview​

Version 1.0.1 represents a major update to the RiverGen API documentation, introducing comprehensive Organizations API enhancements and complete microservices documentation.

What's New in 1.0.1​

[NEW] Organizations API Expansion​

  • 23 new endpoints added (total: 32 endpoints, up from 9)
    • Organization settings management (3 endpoints)
      • Get organization settings
      • Update organization settings
      • Update organization branding
    • Organization member management (3 endpoints)
      • List organization members
      • Get organization member
      • Update organization member
    • Workspace management enhancements (5 endpoints)
      • Create workspace
      • Get workspace
      • Update workspace
      • Delete workspace
      • List workspaces
    • Workspace member management (5 endpoints)
      • List workspace members
      • Add workspace member
      • Update workspace member
      • Remove workspace member
      • Get workspace member
    • Security logs (2 endpoints)
      • List security logs
      • Get security log
    • Branding and image uploads (7 endpoints)
      • Upload organization logo
      • Upload organization favicon
      • Upload organization banner
      • Get organization logo
      • Get organization favicon
      • Get organization banner
      • Delete organization image

[NEW] Microservices Documentation​

Complete documentation for all internal microservices:

  • Data Orchestration Service (17 endpoints)

    • Query execution and data plans
    • Catalog management
    • Data lineage tracking
    • Schema discovery
    • Connector management
    • Health and metrics

  • Storage Service (22 endpoints)

    • File management (upload, download, delete, list)
    • Quota tracking and management
    • Vector storage and search
    • Model registry and artifacts
    • Cache management
    • Lifecycle management

  • Staging Service (8 endpoints - not implemented)

    • Job management (create, get, list, pause, resume, cancel)
    • Chunk management (acknowledge, refresh URL)

Complete Feature List - Version 1.0.1​

Individual Account APIs​

  • Authentication (24 endpoints)

    • User registration and login
    • Email verification
    • Password management
    • OAuth integration
    • Social account linking
    • Profile management

  • Sessions (2 endpoints)

    • List active sessions
    • Revoke sessions

  • MFA (10 endpoints)

    • TOTP setup and verification
    • Email OTP setup and verification
    • Backup codes management
    • MFA status and deactivation

  • WebAuthn (6 endpoints)

    • Passwordless authentication
    • Hardware key registration
    • Biometric authentication

  • Devices (4 endpoints)

    • Trusted device management
    • Device activation and revocation

  • Personal Access Tokens (4 endpoints)

    • Token creation and management
    • Token revocation

  • OAuth Applications (7 endpoints)

    • Application management
    • Secret regeneration

  • OAuth2 (6 endpoints)

    • OAuth 2.0 authorization flows
    • Token management

Organization Account APIs​

  • Organizations (32 endpoints) [Up]

    • Organization creation and management
    • Workspace management
    • Member management
    • Settings and branding
    • Security logs

  • Invitations (4 endpoints)

    • Send and manage invitations
    • Invitation acceptance

  • SSO (19 endpoints)

    • Single Sign-On configuration
    • SAML and OIDC support
    • SSO provider management

  • SSO Enforcement (5 endpoints)

    • SSO policy enforcement
    • Bypass management

  • Roles & Permissions (15 endpoints)

    • Role creation and management
    • Permission assignment
    • Role-based access control

  • User Management (13 endpoints)

    • User provisioning
    • User profile management
    • User status management

  • Workspaces (9 endpoints)

    • Workspace creation and management
    • Workspace member management

  • SCIM (10 endpoints)

    • SCIM 2.0 protocol support
    • User and group provisioning

  • Organization Tokens (3 endpoints)

    • Organization-level token management

Shared APIs (Available to Both Individual and Organization)​

  • Authentication (24 endpoints)
  • Sessions (2 endpoints)
  • MFA (10 endpoints)
  • WebAuthn (6 endpoints)
  • Devices (4 endpoints)
  • Personal Access Tokens (4 endpoints)
  • OAuth Applications (7 endpoints)
  • OAuth2 (6 endpoints)

Platform APIs (Available to Both Individual and Organization)​

  • Data Sources (12 endpoints)

    • Connect to 30+ data sources
    • Schema discovery
    • Connection testing
    • Health monitoring

  • Storage (9 endpoints)

    • File upload and management
    • Presigned URL generation
    • Storage quota management

  • Policies (8 endpoints)

    • Data governance policies
    • Row-level security
    • Data masking

  • Prompt Studio (15 endpoints)

    • Natural language query execution
    • Prompt management
    • Template system
    • Execution history and analytics

Microservices (Internal Services)​

  • Data Orchestration Service (17 endpoints)
  • Storage Service (22 endpoints)
  • Staging Service (8 endpoints - not implemented)

Total Endpoint Count - Version 1.0.1​

  • Individual APIs: 63 endpoints
  • Organization APIs: 110 endpoints
  • Shared APIs: 63 endpoints
  • Platform APIs: 44 endpoints
  • Microservices: 47 endpoints
  • Total: 327 endpoints

Version 1.0.0 - Initial Release​

Release Date: Initial Release
Status: Archived

Overview​

Version 1.0.0 represents the initial release of the RiverGen API documentation, containing the core API endpoints and features available at launch.

What's Included in 1.0.0​

Individual Account APIs​

  • Authentication (24 endpoints)

    • User registration and login
    • Email verification
    • Password management
    • OAuth integration
    • Social account linking
    • Profile management

  • Sessions (2 endpoints)

    • List active sessions
    • Revoke sessions

  • MFA (10 endpoints)

    • TOTP setup and verification
    • Email OTP setup and verification
    • Backup codes management
    • MFA status and deactivation

  • WebAuthn (6 endpoints)

    • Passwordless authentication
    • Hardware key registration
    • Biometric authentication

  • Devices (4 endpoints)

    • Trusted device management
    • Device activation and revocation

  • Personal Access Tokens (4 endpoints)

    • Token creation and management
    • Token revocation

  • OAuth Applications (7 endpoints)

    • Application management
    • Secret regeneration

  • OAuth2 (6 endpoints)

    • OAuth 2.0 authorization flows
    • Token management

Organization Account APIs​

  • Organizations (9 endpoints)

    • Organization creation
    • Organization retrieval
    • Organization updates
    • Basic workspace management
    • Member invitations

  • Invitations (4 endpoints)

    • Send and manage invitations
    • Invitation acceptance

  • SSO (19 endpoints)

    • Single Sign-On configuration
    • SAML and OIDC support
    • SSO provider management

  • SSO Enforcement (5 endpoints)

    • SSO policy enforcement
    • Bypass management

  • Roles & Permissions (15 endpoints)

    • Role creation and management
    • Permission assignment
    • Role-based access control

  • User Management (13 endpoints)

    • User provisioning
    • User profile management
    • User status management

  • Workspaces (9 endpoints)

    • Workspace creation and management
    • Basic workspace operations

  • SCIM (10 endpoints)

    • SCIM 2.0 protocol support
    • User and group provisioning

  • Organization Tokens (3 endpoints)

    • Organization-level token management

Shared APIs (Available to Both Individual and Organization)​

  • Authentication (24 endpoints)
  • Sessions (2 endpoints)
  • MFA (10 endpoints)
  • WebAuthn (6 endpoints)
  • Devices (4 endpoints)
  • Personal Access Tokens (4 endpoints)
  • OAuth Applications (7 endpoints)
  • OAuth2 (6 endpoints)

Platform APIs (Available to Both Individual and Organization)​

  • Data Sources (12 endpoints)

    • Connect to 30+ data sources
    • Schema discovery
    • Connection testing
    • Health monitoring

  • Storage (9 endpoints)

    • File upload and management
    • Presigned URL generation
    • Storage quota management

  • Policies (8 endpoints)

    • Data governance policies
    • Row-level security
    • Data masking

  • Prompt Studio (15 endpoints)

    • Natural language query execution
    • Prompt management
    • Template system
    • Execution history and analytics

What's NOT Included in 1.0.0​

  • [Not Available] Microservices documentation
  • [Not Available] Enhanced Organizations API (only 9 endpoints, not 32)
  • [Not Available] Workspace member management endpoints
  • [Not Available] Organization settings and branding endpoints
  • [Not Available] Security logs endpoints

Total Endpoint Count - Version 1.0.0​

  • Individual APIs: 63 endpoints
  • Organization APIs: 87 endpoints (9 Organizations + 78 other)
  • Shared APIs: 63 endpoints
  • Platform APIs: 44 endpoints
  • Microservices: 0 endpoints (not documented)
  • Total: 257 endpoints

Version Comparison​

Featurev1.0.0v1.0.1
Individual APIs6363
Organization APIs87110
Organizations Endpoints932
Shared APIs6363
Platform APIs4444
Microservices[Not Available] Not documented[OK] 47 endpoints
Total Endpoints257327

Key Differences​

  1. Organizations API: Expanded from 9 to 32 endpoints (+23 endpoints)
  2. Microservices: Added complete documentation for 3 services (47 endpoints)
  3. Total Growth: +70 new endpoints documented

Migration Guide​

Upgrading from v1.0.0 to v1.0.1​

If you're using the Organizations API, be aware of the new endpoints:

  1. Organization Settings: New endpoints for managing organization settings and branding
  2. Member Management: Enhanced member management with more granular controls
  3. Workspace Management: Expanded workspace operations including member management
  4. Security Logs: New endpoints for accessing security audit logs

Breaking Changes​

  • None: All v1.0.0 endpoints remain available and unchanged in v1.0.1

New Features​

  • Microservices Documentation: Complete API documentation for internal microservices
  • Enhanced Organizations API: More comprehensive organization and workspace management

Version Support​

  • v1.0.1: Current/Latest - Full support
  • v1.0.0: Archived - Available for reference only