Skip to main content
Use organization tools to find your organization, manage team members and custom roles, set credit limits, retrieve audit events, and export data.

​
Organizations

list_organizations returns the organization_id used by the other organization tools.

​
Teams

Use team_id from list_teams. When adding a member, you can set the optional is_admin field to make them a team admin.

​
Custom roles and credit limits

Only organization Admins can use these tools. Get custom_role_id from list_custom_role_credit_limits. monthly_credit_limit is a per-member monthly limit; pass null to clear it so the role sets no limit of its own. The optional user_id defaults to you. Learn more about Custom roles.

​
Audit logs

Audit logs are available through MCP and the Retrieve audit logs REST endpoint, with MCP accepting an optional max_limit and handling pagination automatically. REST also supports filters by event type, user, IP address, workspace, or entity. Only organization Admins can read audit logs.

​
Data exports

Only organization Admins can create exports. Use these steps to export organization data:
  1. Call export_data with a data_type, date range, and export_fields.
  2. Poll get_export_status with the returned data_export_id until it reports COMPLETED.
  3. Request the download URL.
Supported data_type values: workflows, agents, agent_interactions, credit_logs, and gumstack. Audit logs aren’t an export type. Retrieve them with get_audit_logs or use the Usage data export guide to set up an audit log data drain.
The aggregated charts on the Organization Insights dashboard aren’t available over MCP or the REST API. This includes overview totals, model usage, leaderboards, skill adoption, and artifact analytics. Use data exports for the underlying rows.

​
Example prompts

List the teams I belong to.

Add jane@acme.com to the Marketing team as a team admin.

Set the Engineering custom role's monthly credit limit to 5,000 credits.

List our custom roles and their monthly credit limits.

Add jane@acme.com to the Sales custom role.

Pull our audit logs for the last 7 days and summarize the credential_retrieval events.

Export my organization's agent interactions for the last 30 days and tell me when the CSV is ready.