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

# Segment

> Connect Segment to your Atako agents — 14 read and 1 write actions.

Let your agents inspect your Segment workspace — sources, destinations, warehouses, tracking plans, spaces, audiences and event volume.

## Connection

* **Authentication**: API key (Workspace access token).
* **Required settings**:
  * **API host** — api.segmentapis.com for US workspaces, eu1.api.segmentapis.com for EU-hosted workspaces.

<Note>
  Segment → Workspace Settings → Access Management → Tokens → Create token. Give it the "Workspace Owner" role (or Source Admin for read-only). Copy the token — it starts with a random string. The API host is api.segmentapis.com for US workspaces, or eu1.api.segmentapis.com for EU-hosted workspaces.

  See [Segment's documentation](https://docs.segmentapis.com/tag/Workspaces).
</Note>

## Read actions (14)

| Action | Description |
| - | - |
| `get_destination` | Get a destination by its id — includes name, enabled status, metadata and settings. |
| `get_events_volume` | Get event volume from the workspace over a time window. granularity: DAY, HOUR or MINUTE. start\_time and end\_time: ISO 8601 timestamps. group\_by: array of dimensions (source, eventName, eventType). |
| `get_source` | Get a source by its id — includes slug, name, enabled status, write keys, metadata and settings. |
| `get_tracking_plan` | Get a tracking plan by its id — includes name, description, type and timestamps. |
| `get_workspace` | Get the workspace associated with the token — name and slug. Use it to confirm the token works. |
| `list_audiences` | List audiences in a space. Returns audience id, name, description, enabled status, audience type and definition. |
| `list_destinations` | List destinations in the workspace. Returns destination id, name, enabled status, metadata and settings. |
| `list_labels` | List labels in the workspace — key, value and description for each. |
| `list_source_catalog` | List available source types in the Segment catalog — metadata id, slug, name, description and categories. |
| `list_sources` | List sources in the workspace. Returns source id, slug, name, enabled status, write keys, metadata and settings. |
| `list_spaces` | List spaces (Personas environments) in the workspace. |
| `list_tracking_plan_rules` | List rules in a tracking plan — each rule has a key, type, version and jsonSchema. |
| `list_tracking_plans` | List tracking plans in the workspace. Returns plan id, name, description and type. |
| `list_warehouses` | List warehouses in the workspace. Returns warehouse id, name, enabled status, metadata and settings. |

## Write actions (1)

| Action | Description |
| - | - |
| `update_destination` | Update a destination. Enable or disable it, or change its display name. Arguments: destinationId (string, path), enabled (boolean, optional), name (string, optional, new display name). |

## Permissions

Every action above must be explicitly granted to an agent before it can be used. See [Permissions](/integrations/permissions) for the grant model and [Security](/integrations/security) for how credentials are protected.

***

*Last reviewed against the provider API: September 2026.*


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.