Skip to main content

​
About Sigma Computing

Sigma Computing is a cloud-based business intelligence and analytics platform that enables teams to explore, analyze, and visualize data from various sources. Connecting Sigma to Serval enables automated user management, team administration, and workbook operations directly from your workflows.

​
What the Sigma Computing integration enables

CapabilityDescription
Automation WorkflowsBuild Serval workflows to automate anything accessible via Sigma’s REST APIs
All resources exposed by the Sigma REST API v2 are available to Serval workflows, including:
  • Members: User management (create, update, deactivate, list)
  • Teams: Team management (create, update, list, manage members)
  • Workbooks: Analytics workbook management (list, export, permissions)
  • Connections: Data warehouse connection management
  • Datasets: Dataset management
  • Workspaces: Workspace management
  • User Attributes: Row-level security configuration
  • Grants: Permission management

​
Sigma Computing Configuration

​
Prerequisites

Before configuring the Sigma Computing integration in Serval, ensure you have:
  • Administrator access to your Sigma Computing account
  • Permissions to access the Administration section
  • Ability to create API credentials in Developer Access
These steps require Sigma administrator privileges. If you do not have these privileges, contact your Sigma administrator.

​
Step 1: Create API Credentials

1

Access Developer Settings

  1. Log in to your Sigma Computing account
  2. Navigate to Administration (click your profile icon in the top right)
  3. Select Developer Access from the left sidebar
2

Create API Client

  1. Click Create New or Add Client in the API Clients section
  2. Fill in the client information:
    • Name: Enter a descriptive name (e.g., “Serval Integration”)
    • Description: Optional description for your reference
  3. Click Create to generate the credentials
3

Copy Credentials

After creating the API client, you’ll see:
  • Client ID: Copy this value
  • Client Secret: Copy this value immediately
The Client Secret is only shown once. Store it securely. If you lose it, you’ll need to regenerate the credentials.
4

Identify Your API Base URL

Your API base URL depends on your cloud provider and region. You can find this in the Developer Access section, or refer to the table below:
Cloud ProviderRegionAPI Base URL
AWSUS Westaws-api.sigmacomputing.com
AWSUS Eastapi.us-a.aws.sigmacomputing.com
AWSCanadaapi.ca.aws.sigmacomputing.com
AWSEuropeapi.eu.aws.sigmacomputing.com
AWSUnited Kingdomapi.uk.aws.sigmacomputing.com
AWSAustraliaapi.au.aws.sigmacomputing.com
AzureUSapi.us.azure.sigmacomputing.com
AzureEuropeapi.eu.azure.sigmacomputing.com
AzureCanadaapi.ca.azure.sigmacomputing.com
AzureUnited Kingdomapi.uk.azure.sigmacomputing.com
GCP-api.sigmacomputing.com
Your API base URL is typically shown in the Developer Access section of Sigma’s Administration panel.

​
Serval Configuration

Once you have created your Sigma API credentials, follow these steps to configure the integration in Serval:
1

Navigate to Sigma Integration

  1. In Serval, go to Apps → Available → Sigma Computing → Connect
  2. The Sigma Computing configuration form will appear
2

Enter Configuration Details

Fill in the following fields with the information from your Sigma configuration:
FieldDescriptionExample
API Base URLYour Sigma API base URL (without https://)aws-api.sigmacomputing.com
Client IDThe Client ID from Step 1abc123def456...
Client SecretThe Client Secret from Step 1••••••••••••
Enter the API Base URL without the https:// prefix. For example, use aws-api.sigmacomputing.com instead of https://aws-api.sigmacomputing.com.
3

Submit Configuration

  1. Click Submit to complete the integration setup
  2. Serval will verify the connection using your credentials

​
API Rate Limits

Be aware of the following rate limits when building workflows with Sigma:
  • The authentication token endpoint is rate limited to 1 request per second
  • API tokens expire after 1 hour (Serval handles token refresh automatically)
  • Most endpoints support pagination with a default page size of 50 and maximum of 1000
Serval automatically handles token expiration and refresh, so you don’t need to manage authentication in your workflows.
Need help? Contact support@serval.com for assistance with your Sigma Computing integration.