views

POST /views

Changed on Nov 2, 2026

Creates a view, a named APL query that you can query like a dataset. Axiom derives datasets from aplQuery. The name can't match an existing dataset or view, and the query can't reference views or use wildcards.

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|create
TypeScript
https://skmtc.dev/axiom/apis/axiom-public-api/docs/views/post.ts
A function with typed inputs. Its response is checked against the schema.

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

Created view.