Update view

PUT/v2/views/{id}

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.

Parameters

Property	Type	Location	Description
`id`	`string`Required	`path`	Name of the view

Body

application/json

Property	Type	Description
`aplQuery`	`string`Required	APL query that defines the view
`datasets`	`string[]`	Datasets the view queries. Axiom derives this from `aplQuery` and ignores it in requests.
`description`	`string`
`name`	`string`Required	Name of the view. Use it as the view ID and to query the view like a dataset.
`sharedByOrg`	`string`	ID of the org that shared this resource, if it's shared
`sharedByOrgName`	`string`	The name of the org that shared this resource, if it's shared

Request

curl -X PUT 'https://api.axiom.co/v2/views/ID' \
  -H 'Authorization: Bearer API_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"aplQuery":"string","datasets":["string"],"description":"string","name":"string","sharedByOrg":"string","sharedByOrgName":"string"}'

Try itRun this request against your Axiom organization

Credentials stay in this browser tab and are only sent to Axiom when you run the request.

API token Requiredid pathRequiredRequest body application/json

Response

200Updated view.

application/json

403You don't have query access to the view's current or new datasets.

404View not found.

Property	Type	Description
`aplQuery`	`string`Required	APL query that defines the view
`datasets`	`string[]`	Datasets the view queries. Axiom derives this from `aplQuery` and ignores it in requests.
`description`	`string`
`name`	`string`Required	Name of the view. Use it as the view ID and to query the view like a dataset.
`sharedByOrg`	`string`	ID of the org that shared this resource, if it's shared
`sharedByOrgName`	`string`	The name of the org that shared this resource, if it's shared