Teams

Teams are the organizational unit in Catalyzed. All resources (datasets, pipelines, files) belong to a team, and team membership determines access and permissions.

Team Structure

Every Catalyzed account is associated with one or more teams:

• Personal Team - Created automatically for each user
• Organization Teams - Shared teams for collaboration

Roles and Permissions

Team members can have different roles:

Role	Permissions
Owner	Full access, can delete team, manage billing
Admin	Manage members, create/delete resources
Member	Create and modify resources

Team Context in the API

Resources in Catalyzed are team-scoped. When making API requests:

• Creating resources: Include teamId in the request body
• Accessing resources: Authorization is checked based on the resource’s team
• Listing resources: Filter by teamIds query parameter

# Create a dataset in a specific team
curl -X POST https://api.catalyzed.ai/datasets \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "my-dataset",
    "teamId": "team_abc123"
  }'

# List datasets filtered by team
curl "https://api.catalyzed.ai/datasets?teamIds=team_abc123" \
  -H "Authorization: Bearer YOUR_TOKEN"

Billing and Credits

Teams have their own:

• Credit balance - Used for compute and storage
• Usage tracking - Per-team metering of resource consumption

Checking Credit Balance

curl https://api.catalyzed.ai/teams/{teamId}/credits/balance \
  -H "Authorization: Bearer YOUR_TOKEN"

Viewing Credit Ledger

curl https://api.catalyzed.ai/teams/{teamId}/credits/ledger \
  -H "Authorization: Bearer YOUR_TOKEN"