Usage Data Export allows enterprise organization administrators to export comprehensive workflow data from their Gumloop organization. This feature provides systematic data extraction for analysis, compliance reporting, credit consumption tracking, and backup purposes.

​
Overview

The Usage Data Export feature enables organizations to:
  • Track Credit Consumption: Monitor credit usage across workspaces and users over time
  • Compliance Reporting: Export data for audit trails and regulatory compliance
  • Usage Analytics: Analyze workflow execution patterns and user activity
  • Data Backup: Create backups of organizational workflow metadata
  • Billing Analysis: Understand cost allocation across teams and projects

​
Accessing Data Export

Navigate to your organization’s data export settings at: gumloop.com/settings/organization/data_export
Usage Data Export Overview

​
Export Process

The data export follows a simple three-step workflow:

​
Step 1: Date Range Selection

Define the time period for your data extraction.
Date Range Selection
Features:
  • Calendar Picker Interface: Easy date selection with visual calendar
  • Date Validation: End date must be on or after start date
  • Format: MM/DD/YYYY format
  • Range Flexibility: Select any date range within your organization’s data history

​
Step 2: Workspace Selection

Choose which workspaces to include in your export.
Workspace Selection
Organization Workspaces:
  • Searchable List: Find workspaces quickly using search functionality
  • Individual Selection: Choose specific workspaces with checkboxes
  • Select All Toggle: Bulk select all organization workspaces
Personal Workspaces:
  • Optional Toggle: Include personal workspaces of organization members
  • Comprehensive Coverage: When enabled, includes all user personal workspaces in the export
Workspace Selection

​
Step 3: Data Field Selection

Select which data categories and fields to include in your export.
Data Field Selection
Available Data Categories:

​
1. Workspace Information

Workspace IDWorkspace Name

​
2. Workbook Information

Workbook IDWorkbook NameCreated Timestamp

​
3. User Information

User IDUser Email

​
4. Run Information

Run IDCredit CostCreated TimestampFinished Timestamp

​
Export History and Management

​
Export History Tab

Monitor and manage all your previous export requests.
Export History
Features:
  • Status Tracking: Real-time status updates with colored badges
  • Date Range Display: Clear indication of exported data timeframes
  • Creation Timestamps: When each export was requested
  • Download Actions: Direct CSV file download capability

​
Email Notifications

When your export completes successfully, you’ll receive an email notification with confirmation that your export is ready.

​
Downloaded Data Format

​
CSV Output Structure

Exported data is provided as CSV files with:
  • Header Row: Column names matching selected fields
  • Comma Separation: Standard CSV format for easy import into analysis tools
  • Date Formatting: ISO 8601 timestamp format

​
API Integration

For programmatic access to data export functionality:

​
Create Data Export

Endpoint: POST /export_data Request Body: 
{
  "user_id": "string",
  "export_fields": [
    "workbook_id",
    "workbook_name", 
    "user_email",
    "run_id",
    "credit_cost",
    "pl_run_created_ts",
    "pl_run_finished_ts"
  ],
  "start_date": "2024-01-01T00:00:00",
  "end_date": "2024-12-31T23:59:59",
  "include_personal_workspaces": false,
  "workspace_ids": ["workspace_id_1", "workspace_id_2"]
}

​
Check Export Status

Endpoint: GET /export_status Query Parameters:
  • user_id (required): User requesting the status
  • data_export_id (required): Export job identifier
  • download (optional): Set to true to download the file if completed
For complete API documentation, see: Gumloop API Reference

​
See Also