Skip to main content
Usage Data Export allows enterprise organization administrators to export comprehensive data from their Gumloop organization. This feature supports exporting workflow runs, agent data, and credit logs for analysis, compliance reporting, credit consumption tracking, and backup purposes.

​
What You Can Do

Track Credit Consumption

Monitor credit usage across teams 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
Navigate to your organization’s data export settings at: gumloop.com/settings/organization/data_export
Usage Data Export Overview

​
Export Types

Gumloop supports three types of data export:
Export TypeDescription
Workflow RunsExecution history including run IDs, credit costs, timestamps, and workflow metadata
AgentsAgent configurations including names, models, tools, system prompts, and creator info
Credit LogsComplete credit transaction history including charges, balances, categories, and user attribution

​
Export Process

The data export follows a simple workflow:

Select Export Type

Choose what data you want to export: Workflow Runs, Agents, or Credit Logs.

Select Date Range

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

Choose Teams

Select which teams to include in your export.
This step applies to Workflow Runs and Agents exports only. Credit Logs exports are always scoped to the entire organization — team selection is not applicable.
Team Selection
  • Searchable List: Find teams quickly using search functionality
  • Individual Selection: Choose specific teams with checkboxes
  • Select All Toggle: Bulk select all organization teams
  • Optional Toggle: Include personal spaces of organization members
  • Comprehensive Coverage: When enabled, includes all user personal spaces in the export
Personal Space Selection

Select Data Fields

Choose which data categories and fields to include in your export.
Data Field Selection

​
Available Data Categories

FieldDescription
Team IDUnique identifier for the team
Team NameDisplay name of the team

​
Managing Your Exports

​
Export History

Monitor and manage all your previous export requests from the History tab.
Export History
What You’ll See:
  • 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
When your export completes successfully, you’ll receive an email notification confirming that your export is ready for download.

​
Downloaded Data Format

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, use the following endpoints:
Endpoint: POST /export_dataRequest 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"],
  "entity_ids": ["workbook_id_1", "workbook_id_2"]
}
Optional Parameters:
  • data_type: The type of data to export ("workflows", "agents", or "credit_logs"). Defaults to "workflows".
  • entity_ids: Filter the export to specific entities. For workflow exports, provide workbook IDs. For agent exports, provide agent IDs. Not applicable for credit log exports.
Credit log exports work differently from workflow and agent exports:
  • Team/workspace selection parameters (workspace_ids, include_personal_workspaces) are not applicable
  • Credit log exports are always scoped to the entire organization
  • Use category_filter to filter by a specific credit log category (e.g., "PIPELINE_RUN", "AGENT_RUN")
Endpoint: GET /export_statusQuery 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

Complete API Documentation

View the full API reference for detailed endpoint specifications and examples

Custom User Roles

Learn about managing user permissions and roles

Organizations and Teams

Understand how to structure your Gumloop organization