V2 endpoints

Axiom introduces version 2 (V2) API endpoints that let you manage new Axiom resources programmatically. For more information, see the list of API endpoints.

New endpoints

The following endpoints are new ways to programmatically create, read, update, and delete Axiom resources. Previously, you could only manage these resources from the UI:

• Groups
• Monitors
• Notifiers
• Organizations
• Roles
• Starred queries
• Users
• Virtual fields

Axiom added new endpoints for the following tasks:

• Retrieve information about fields and update them
• Vacuum datasets

To work with the new endpoints, use advanced API tokens with the correct permissions. For example, to create users programmatically, first create an advanced API token with these privileges, and use this token to authenticate your request to the users endpoint.

New version of existing endpoints

Axiom introduces V2 of the following existing endpoints:

• List all datasets
• Create dataset
• Retrieve dataset
• Update dataset
• Trim dataset
• Delete dataset
• Retrieve current user

For these tasks, Axiom recommends you use the new V2 endpoints. The functionality and the interface are unchanged, and the properties remain the same as before. V1 endpoints continue to be supported and you can use them as before. The V2 endpoints offer backend improvements over their V1 counterparts. This enables more efficient and maintainable service from Axiom in the future.