From be2ea6a0c77412effa137153d038ffc0ff6671b0 Mon Sep 17 00:00:00 2001 From: Mano Toth Date: Tue, 2 Dec 2025 08:58:07 +0100 Subject: [PATCH 1/5] Replace non-ingest endpoints with api.axiom.co --- apl/data-types/map-fields.mdx | 4 +--- query-data/annotate-charts.mdx | 21 +++++++-------------- restapi/delete-blocks.mdx | 4 +--- 3 files changed, 9 insertions(+), 20 deletions(-) diff --git a/apl/data-types/map-fields.mdx b/apl/data-types/map-fields.mdx index a429816fc..7e685bee3 100644 --- a/apl/data-types/map-fields.mdx +++ b/apl/data-types/map-fields.mdx @@ -4,7 +4,6 @@ description: 'This page explains what map fields are and how to query them.' keywords: ['axiom documentation', 'documentation', 'axiom', 'map fields', 'object fields', 'data types'] --- -import ReplaceDomain from "/snippets/replace-domain.mdx" import ReplaceDatasetToken from "/snippets/replace-dataset-token.mdx" Map fields are a special type of field that can hold a collection of nested key-value pairs within a single field. You can think of the content of a map field as a JSON object. @@ -56,7 +55,7 @@ To create a map field using the Axiom API, send a request to the [Create map fie ```bash curl --request POST \ - --url https://AXIOM_DOMAIN/v2/datasets/{DATASET_NAME}/mapfields \ + --url https://api.axiom.co/v2/datasets/DATASET_NAME/mapfields \ --header 'Authorization: Bearer API_TOKEN' \ --header 'Content-Type: application/json' \ --data '{ @@ -65,7 +64,6 @@ curl --request POST \ ``` - Replace `MAP_FIELD` with the name of the field that you want to change to a map field. diff --git a/query-data/annotate-charts.mdx b/query-data/annotate-charts.mdx index f3fbea03f..e7cacc0b9 100644 --- a/query-data/annotate-charts.mdx +++ b/query-data/annotate-charts.mdx @@ -8,7 +8,6 @@ keywords: ['axiom documentation', 'documentation', 'axiom', 'annotation', 'span' import Prerequisites from "/snippets/minimal-prerequisites.mdx" import ReplaceDatasetToken from "/snippets/replace-dataset-token.mdx" import ReplaceToken from "/snippets/replace-token.mdx" -import ReplaceDomain from "/snippets/replace-domain.mdx" Annotating charts lets you add context to your charts. For example, use annotations to mark the time of the following: @@ -67,7 +66,7 @@ This creates an annotation in Axiom each time you deploy in GitHub. To create an annotation using the Axiom API, use the following API request: ```bash -curl -X 'POST' 'https://AXIOM_DOMAIN/v2/annotations' \ +curl -X 'POST' 'https://api.axiom.co/v2/annotations' \ -H 'Authorization: Bearer API_TOKEN' \ -H 'Content-Type: application/json' \ -d '{ @@ -81,7 +80,6 @@ curl -X 'POST' 'https://AXIOM_DOMAIN/v2/annotations' \ ``` - @@ -108,12 +106,11 @@ The API response from Axiom contains an `id` field. This is the annotation ID th To get information about all datasets in your org, use the following API request: ```bash -curl -X 'GET' 'https://AXIOM_DOMAIN/v2/annotations' \ +curl -X 'GET' 'https://api.axiom.co/v2/annotations' \ -H 'Authorization: Bearer API_TOKEN' ``` - @@ -125,7 +122,7 @@ Use the following parameters in the endpoint URL to filter for a specific time i The example below gets information about annotations about occurrences between March 16th and 19th, 2024 and added to the dataset `my-dataset`: ```bash -curl -X 'GET' 'https://AXIOM_DOMAIN/v2/annotations?start=2024-03-16T00:00:00.000Z&end=2024-03-19T23:59:59.999Z&datasets=my-dataset' \ +curl -X 'GET' 'https://api.axiom.co/v2/annotations?start=2024-03-16T00:00:00.000Z&end=2024-03-19T23:59:59.999Z&datasets=my-dataset' \ -H 'Authorization: Bearer API_TOKEN' ``` @@ -159,12 +156,11 @@ The API response from Axiom contains an `id` field. This is the annotation ID th To get information about a specific annotation, use the following API request: ```bash -curl -X 'GET' 'https://AXIOM_DOMAIN/v2/annotations/ANNOTATION_ID' \ +curl -X 'GET' 'https://api.axiom.co/v2/annotations/ANNOTATION_ID' \ -H 'Authorization: Bearer API_TOKEN' ``` - Replace `ANNOTATION_ID` with the ID of the annotation. @@ -190,7 +186,7 @@ For more information on these fields, see [Annotation object](#annotation-object To change an existing annotation, use the following API request: ```bash -curl -X 'PUT' 'https://AXIOM_DOMAIN/v2/annotations/ANNOTATION_ID' \ +curl -X 'PUT' 'https://api.axiom.co/v2/annotations/ANNOTATION_ID' \ -H 'Authorization: Bearer API_TOKEN' \ -H 'Content-Type: application/json' \ -d '{ @@ -199,7 +195,6 @@ curl -X 'PUT' 'https://AXIOM_DOMAIN/v2/annotations/ANNOTATION_ID' \ ``` - Replace `ANNOTATION_ID` with the ID of the annotation. For more information about how to determine the annotation ID, see [Get information about annotations](#get-information-about-annotations). In the payload, specify the properties of the annotation that you want to change. The example above adds an `endTime` field to the annotation created above. For more information on the allowed fields, see [Annotation object](#annotation-object). @@ -225,12 +220,11 @@ In the payload, specify the properties of the annotation that you want to change To delete an existing annotation, use the following API request: ```bash -curl -X 'DELETE' 'https://AXIOM_DOMAIN/v2/annotations/ANNOTATION_ID' \ +curl -X 'DELETE' 'https://api.axiom.co/v2/annotations/ANNOTATION_ID' \ -H 'Authorization: Bearer API_TOKEN' \ ``` - Replace `ANNOTATION_ID` with the ID of the annotation. For more information about how to determine the annotation ID, see [Get information about annotations](#get-information-about-annotations). @@ -265,7 +259,7 @@ The example below demonstrates how annotations help you troubleshoot issues in y Use the following API request to create an annotation: ```bash -curl -X 'POST' 'https://AXIOM_DOMAIN/v2/annotations' \ +curl -X 'POST' 'https://api.axiom.co/v2/annotations' \ -H 'Authorization: Bearer API_TOKEN' \ -H 'Content-Type: application/json' \ -d '{ @@ -279,7 +273,6 @@ curl -X 'POST' 'https://AXIOM_DOMAIN/v2/annotations' \ ``` - diff --git a/restapi/delete-blocks.mdx b/restapi/delete-blocks.mdx index b4e400209..b4825b2de 100644 --- a/restapi/delete-blocks.mdx +++ b/restapi/delete-blocks.mdx @@ -5,7 +5,6 @@ sidebarTitle: 'Delete blocks' noindex: "true" --- -import ReplaceDomain from "/snippets/replace-domain.mdx" import ReplaceDatasetToken from "/snippets/replace-dataset-token.mdx" After data ingestion, Axiom stores events in blocks of tens of thousands of events. Currently, you can’t delete individual events after you send them to Axiom, but you can delete entire blocks of data. With the `/v2/datasets/_apl/delete` endpoint, you can specify an APL query and delete all blocks that contain matching events. @@ -50,7 +49,7 @@ When you make a successful request with `commit` set to `true`, blocks containin ## Example request ```bash -curl -X 'POST' 'https://AXIOM_DOMAIN/v2/datasets/_apl/delete' \ +curl -X 'POST' 'https://api.axiom.co/v2/datasets/_apl/delete' \ -H 'Authorization: Bearer API_TOKEN' \ -H 'Content-Type: application/json' \ -d '{ @@ -62,7 +61,6 @@ curl -X 'POST' 'https://AXIOM_DOMAIN/v2/datasets/_apl/delete' \ ``` - From 86f534df432f2aef7d98942fc87fe8e46ae240c2 Mon Sep 17 00:00:00 2001 From: Mano Toth Date: Tue, 2 Dec 2025 09:09:52 +0100 Subject: [PATCH 2/5] More non-ingest endpoints --- console/intelligence/mcp-server.mdx | 7 ++----- restapi/pagination.mdx | 25 ++++++++----------------- 2 files changed, 10 insertions(+), 22 deletions(-) diff --git a/console/intelligence/mcp-server.mdx b/console/intelligence/mcp-server.mdx index 0ba10ad05..c7c706c76 100644 --- a/console/intelligence/mcp-server.mdx +++ b/console/intelligence/mcp-server.mdx @@ -5,7 +5,6 @@ sidebarTitle: MCP Server --- import Prerequisites from "/snippets/minimal-prerequisites.mdx" -import ReplaceDomain from "/snippets/replace-domain.mdx" import ReplaceToken from "/snippets/replace-token.mdx" import PrerequisiteToken from "/snippets/prerequisite-token.mdx" @@ -195,7 +194,7 @@ Configure your AI agent to use the MCP Server in one of the following ways: ```bash config.txt token API_TOKEN - url https://AXIOM_DOMAIN + url https://api.axiom.co query-rate 1 query-burst 1 datasets-rate 1 @@ -206,8 +205,6 @@ Configure your AI agent to use the MCP Server in one of the following ways: - - Optionally, configure the rate and the burst limits at the query, dataset, and monitor levels. The rate limit is the maximum number of requests that your AI agent can make per second. The burst limit is the maximum number of requests that your AI agent can make in a short period (burst) before the rate limit applies to further requests. @@ -249,7 +246,7 @@ For example, if you use the Claude desktop app, add `axiom` to the `mcpServers` "command": "PATH_AXIOM_MCP_BINARY", "env": { "AXIOM_TOKEN": "API_TOKEN", - "AXIOM_URL": "https://AXIOM_DOMAIN", + "AXIOM_URL": "https://api.axiom.co", "AXIOM_QUERY_RATE": "1", "AXIOM_QUERY_BURST": "1", "AXIOM_DATASETS_RATE": "1", diff --git a/restapi/pagination.mdx b/restapi/pagination.mdx index cb0cd28d2..be80ff141 100644 --- a/restapi/pagination.mdx +++ b/restapi/pagination.mdx @@ -5,7 +5,6 @@ sidebarTitle: Pagination keywords: ['axiom documentation', 'documentation', 'axiom', 'axiom api', 'rest api', 'rest', 'pagination', 'cursor', 'query'] --- -import ReplaceDomain from "/snippets/replace-domain.mdx" import ReplaceDatasetToken from "/snippets/replace-dataset-token.mdx" import Prerequisites from "/snippets/standard-prerequisites.mdx" @@ -79,7 +78,7 @@ Both the Run Query and the Run Query (Legacy) endpoints allow request-based limi #### Example request Run Query ```bash -curl -X 'POST' 'https://AXIOM_DOMAIN/v1/datasets/_apl?format=tabular' \ +curl -X 'POST' 'https://api.axiom.co/v1/datasets/_apl?format=tabular' \ -H 'Authorization: Bearer API_TOKEN' \ -H 'Content-Type: application/json' \ -d '{ @@ -90,14 +89,13 @@ curl -X 'POST' 'https://AXIOM_DOMAIN/v1/datasets/_apl?format=tabular' \ ``` - #### Example request Run Query (Legacy) ```bash -curl -X 'POST' 'https://AXIOM_DOMAIN/v1/datasets/DATASET_NAME/query' \ +curl -X 'POST' 'https://api.axiom.co/v1/datasets/DATASET_NAME/query' \ -H 'Authorization: Bearer API_TOKEN' \ -H 'Content-Type: application/json' \ -d '{ @@ -109,7 +107,6 @@ curl -X 'POST' 'https://AXIOM_DOMAIN/v1/datasets/DATASET_NAME/query' \ ``` - @@ -118,7 +115,7 @@ curl -X 'POST' 'https://AXIOM_DOMAIN/v1/datasets/DATASET_NAME/query' \ Example request to go to next page for Run Query: ```bash -curl -X 'POST' 'https://AXIOM_DOMAIN/v1/datasets/_apl?format=tabular' \ +curl -X 'POST' 'https://api.axiom.co/v1/datasets/_apl?format=tabular' \ -H 'Authorization: Bearer API_TOKEN' \ -H 'Content-Type: application/json' \ -d '{ @@ -129,14 +126,13 @@ curl -X 'POST' 'https://AXIOM_DOMAIN/v1/datasets/_apl?format=tabular' \ ``` - Example request to go to next page for Run Query (Legacy): ```bash -curl -X 'POST' 'https://AXIOM_DOMAIN/v1/datasets/DATASET_NAME/query' \ +curl -X 'POST' 'https://api.axiom.co/v1/datasets/DATASET_NAME/query' \ -H 'Authorization: Bearer API_TOKEN' \ -H 'Content-Type: application/json' \ -d '{ @@ -148,7 +144,6 @@ curl -X 'POST' 'https://AXIOM_DOMAIN/v1/datasets/DATASET_NAME/query' \ ``` - @@ -215,7 +210,7 @@ If the query returns fewer results than the specified limit, paging can stop. #### Example request Run Query ```bash -curl -X 'POST' 'https://AXIOM_DOMAIN/v1/datasets/_apl?format=tabular' \ +curl -X 'POST' 'https://api.axiom.co/v1/datasets/_apl?format=tabular' \ -H 'Authorization: Bearer API_TOKEN' \ -H 'Content-Type: application/json' \ -d '{ @@ -226,14 +221,13 @@ curl -X 'POST' 'https://AXIOM_DOMAIN/v1/datasets/_apl?format=tabular' \ ``` - #### Example request Run Query (Legacy) ```bash -curl -X 'POST' 'https://AXIOM_DOMAIN/v1/datasets/DATASET_NAME/query' \ +curl -X 'POST' 'https://api.axiom.co/v1/datasets/DATASET_NAME/query' \ -H 'Authorization: Bearer API_TOKEN' \ -H 'Content-Type: application/json' \ -d '{ @@ -245,7 +239,6 @@ curl -X 'POST' 'https://AXIOM_DOMAIN/v1/datasets/DATASET_NAME/query' \ ``` - @@ -271,7 +264,7 @@ To page through the result set, use the appropriate cursor value in your next re Example request to go to next page for Run Query: ```bash -curl -X 'POST' 'https://AXIOM_DOMAIN/v1/datasets/_apl?format=tabular' \ +curl -X 'POST' 'https://api.axiom.co/v1/datasets/_apl?format=tabular' \ -H 'Authorization: Bearer API_TOKEN' \ -H 'Content-Type: application/json' \ -d '{ @@ -283,14 +276,13 @@ curl -X 'POST' 'https://AXIOM_DOMAIN/v1/datasets/_apl?format=tabular' \ ``` - Example request to go to next page for Run Query (Legacy): ```bash -curl -X 'POST' 'https://AXIOM_DOMAIN/v1/datasets/DATASET_NAME/query' \ +curl -X 'POST' 'https://api.axiom.co/v1/datasets/DATASET_NAME/query' \ -H 'Authorization: Bearer API_TOKEN' \ -H 'Content-Type: application/json' \ -d '{ @@ -303,6 +295,5 @@ curl -X 'POST' 'https://AXIOM_DOMAIN/v1/datasets/DATASET_NAME/query' \ ``` - From 7c7be80e46af417a60202258c70706da2f3bc0aa Mon Sep 17 00:00:00 2001 From: Mano Toth Date: Tue, 2 Dec 2025 09:18:53 +0100 Subject: [PATCH 3/5] Update README.md --- README.md | 1 + 1 file changed, 1 insertion(+) diff --git a/README.md b/README.md index 5c5f7c3d3..263ffca3c 100644 --- a/README.md +++ b/README.md @@ -62,3 +62,4 @@ We value your input and invite you to help us make the Axiom documentation even - If the local build fails, run `mint update`. - If a page loads as a 404, make sure you run the local build in the root folder where the file `docs.json` is present. + From 8f3d6b6b56f1a3f32281221a9c5f56d43013b06a Mon Sep 17 00:00:00 2001 From: Mano Toth Date: Tue, 2 Dec 2025 09:19:20 +0100 Subject: [PATCH 4/5] Update README.md --- README.md | 1 - 1 file changed, 1 deletion(-) diff --git a/README.md b/README.md index 263ffca3c..5c5f7c3d3 100644 --- a/README.md +++ b/README.md @@ -62,4 +62,3 @@ We value your input and invite you to help us make the Axiom documentation even - If the local build fails, run `mint update`. - If a page loads as a 404, make sure you run the local build in the root folder where the file `docs.json` is present. - From 7e73a3d3002ea6b98d856df37797412451853255 Mon Sep 17 00:00:00 2001 From: Mano Toth Date: Tue, 2 Dec 2025 09:22:31 +0100 Subject: [PATCH 5/5] Fix broken link --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 5c5f7c3d3..ecae1f079 100644 --- a/README.md +++ b/README.md @@ -56,7 +56,7 @@ We value your input and invite you to help us make the Axiom documentation even 1. Rate pages. Hit the 👍/👎 button on any page to let us know what you like and what you don’t. 2. Leave feedback. Click **Raise issue** on any documentation page to create a GitHub issue where you can share thoughts and suggestions. 3. Suggest edits. Found a typo or outdated information? Click **Suggest edits** directly on the page. -4. Contribute content. If you have in-depth knowledge or unique use cases, we encourage you to contribute by writing new sections or enhancing existing ones. Before contributing, please read the [Contribution guidelines](/.github/CONTRIBUTING.md) and the [Contributor Covenant](https://www.contributor-covenant.org/version/2/0/code_of_conduct.html). +4. Contribute content. If you have in-depth knowledge or unique use cases, we encourage you to contribute by writing new sections or enhancing existing ones. Before contributing, please read the [Contribution guidelines](https://github.com/axiomhq/docs/blob/main/.github/CONTRIBUTING.md) and the [Contributor Covenant](https://www.contributor-covenant.org/version/2/0/code_of_conduct.html). ## Troubleshooting