> ## 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.*