views

PUT /views/{id}

Changed on Nov 2, 2026

Replaces the aplQuery and description of a view, identified by its name. Axiom ignores name and datasets in the body and derives datasets from the new query.

Request

Base URL
https://api.axiom.co/v2
Auth
OAuth 2
Authorization codehttps://accounts.google.com/o/oauth2/v2/auth
Token URLhttps://www.googleapis.com/oauth2/v4/token
Scopesviews|update
TypeScript
https://skmtc.dev/axiom/apis/axiom-public-api/docs/views/:id/put.ts
A function with typed inputs. Its response is checked against the schema.

Path parameters

idstring required

Name of the view

Request body

aplQuerystring required

APL query that defines the view

datasetsstring[]

Datasets the view queries. Axiom derives this from aplQuery and ignores it in requests.

descriptionstring

edgeDeploymentstring

Region of the source datasets; ignored in requests

edgeDeploymentUrlstring

URL of the edge deployment; ignored in requests

namestring required

Name of the view. Use it as the view ID and to query the view like a dataset.

sharedByOrgstring

ID of the org that shared this resource, if it's shared

sharedByOrgNamestring

The name of the org that shared this resource, if it's shared

Response

Updated view.