> This page is for Workforce.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.merge.dev/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.merge.dev/_mcp/server.

# Axiom

**Authentication:** API key. See [Magic Link](/merge-agent-handler/features/magic-link) for the runtime auth flow.

## Available Tools

#### list_annotations

List annotations, optionally filtered by dataset names and a time range (ISO 8601). Returns annotation IDs, types, datas...

#### get_annotation

Retrieve a single annotation by ID. Use list_annotations to find valid IDs.

#### create_annotation

Create an annotation that appears on charts for the given datasets. Requires a type (lowercase alphanumeric and hyphens)...

#### update_annotation

Update an annotation's fields. Only provided fields are changed. Use list_annotations to find valid IDs.

#### delete_annotation

Permanently delete an annotation by ID. Use list_annotations to find valid IDs.

#### list_datasets

List all datasets in the organization. Returns dataset IDs, names, kinds, descriptions, and retention settings.

#### get_dataset

Retrieve a single dataset by ID. The dataset ID is the same as its name. Use list_datasets to find valid IDs.

#### create_dataset

Create a new dataset. Provide a unique name and optionally a description, kind, and retention settings. Kind defaults to...

#### update_dataset

Update a dataset's description or retention settings. The name and kind cannot be changed. Use list_datasets to find val...

#### delete_dataset

Permanently delete a dataset and all its data. This cannot be undone. Use list_datasets to find valid IDs.

#### trim_dataset

Queue deletion of data older than maxDuration (e.g. '24h', '30d') in a dataset. Deletion may take several hours. Use lis...

#### vacuum_dataset

Vacuum a dataset to prune fields that have not received data recently, reducing the field schema. Use list_datasets to f...

#### list_monitors

List all monitors (alerting rules). Returns monitor IDs, names, types, APL queries, and thresholds.

#### get_monitor

Retrieve a single monitor by ID. Use list_monitors to find valid IDs.

#### get_monitor_history

Retrieve a monitor's alert history (open/closed state changes) within a time range. Requires startTime and endTime (ISO...

#### create_monitor

Create a monitor. Requires a name and type (Threshold, MatchEvent, or AnomalyDetection). Provide an aplQuery plus operat...

#### update_monitor

Update a monitor. Fetches the current monitor and applies only the fields you provide, so omitted fields are preserved....

#### delete_monitor

Permanently delete a monitor by ID. Use list_monitors to find valid IDs.

#### list_notifiers

List all notifiers (alert delivery targets such as email, Slack, or webhook). Returns notifier IDs, names, and type-spec...

#### get_notifier

Retrieve a single notifier by ID. Use list_notifiers to find valid IDs.

#### create_notifier

Create a notifier. Requires a name and a properties object whose shape depends on the type, e.g. 'email': or 'slack': .

#### update_notifier

Update a notifier. Axiom replaces the notifier, so provide both name and the full properties object (fetch current value...

#### delete_notifier

Permanently delete a notifier by ID. Monitors referencing it will no longer deliver to this target. Use list_notifiers t...

#### list_orgs

List the organizations accessible to the current token, including plan information.

#### get_org

Retrieve a single organization by ID. Use list_orgs to find valid IDs.

#### query_apl

Run an APL (Axiom Processing Language) query across one or more datasets and return tabular results. Wrap dataset names...

#### list_tokens

List API tokens in the organization. Returns token metadata (IDs, names, capabilities, expiration). Raw token values are...

#### get_token

Retrieve metadata for a single API token by ID. The raw token value is not returned. Use list_tokens to find valid IDs.

#### get_current_user

Retrieve the user that the current API token belongs to, including their role.

#### list_users

List all users in the organization, including their names, emails, and roles.

#### get_user

Retrieve a single user by ID. Use list_users to find valid IDs.