> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gumloop.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Organization tools

> List teams, retrieve organization audit logs, and export organization data.

Use organization tools to list your teams, retrieve audit events, and export organization data.

## Teams

| Tool | Description | Required inputs |
| - | - | - |
| `list_teams` | List teams (workspaces) the authenticated user belongs to | None |

## Audit logs

| Tool | Description | Required inputs |
| - | - | - |
| `get_audit_logs` | Retrieve organization [audit logs](/enterprise-features/audit_logging) with event details and time-period filtering | `organization_id`, `user_id`, `start_time`, `end_time` |

Audit logs are available through MCP and the [REST API](/api-reference/organization/get-audit-logs), 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

| Tool | Description | Required inputs |
| - | - | - |
| `export_data` | Create an organization data export over a date range | `data_type`, `start_date`, `end_date`, `export_fields` |
| `get_export_status` | Check an export's status and get its completed CSV download URL | `data_export_id` |

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 are not an export type. Retrieve them with `get_audit_logs` or set up an [audit log data drain](/enterprise-features/organization_data_export#data-drains).

<Note>
  The aggregated charts on the Organization Insights dashboard (overview totals, model usage, leaderboards, skill adoption, artifact analytics) aren't available over MCP or the REST API. Use data exports for the underlying rows.
</Note>

## Example prompts

<Prompt description={`List the teams I belong to.`} icon="users" actions={["copy"]}>
  List the teams I belong to.
</Prompt>

<Prompt description={`Pull our audit logs for the last 7 days and summarize the credential_retrieval events.`} icon="shield-halved" actions={["copy"]}>
  Pull our audit logs for the last 7 days and summarize the credential\_retrieval events.
</Prompt>

<Prompt description={`Export my organization's agent interactions for the last 30 days and tell me when the CSV is ready.`} icon="file-export" actions={["copy"]}>
  Export my organization's agent interactions for the last 30 days and tell me when the CSV is ready.
</Prompt>

## Related

* [REST API organization audit logs](/api-reference/organization/get-audit-logs)
* [Gumloop CLI MCP](/cli/mcp)