Environments-29
For instructions on how to authenticate to use this endpoint, see API overview.
Create, Read, Update and Delete Warehouse Tables.
Endpoints
GET | |
POST | |
GET | |
PATCH | |
DELETE | |
GET | |
POST | |
POST | |
GET |
List all environments warehouse saved queries
Required API key scopes
warehouse_view:readPath parameters
- project_idstring
Project ID of the project you're trying to access. To find the ID of the project, make a call to /api/projects/.
Query parameters
- pageinteger
A page number within the paginated result set.
- searchstring
A search term.
Response
Example request
GET /api /environments /:project_id /warehouse_saved_queriesExample response
Status 200
List all environments warehouse saved queries
Required API key scopes
warehouse_view:readPath parameters
- project_idstring
Project ID of the project you're trying to access. To find the ID of the project, make a call to /api/projects/.
Query parameters
- pageinteger
A page number within the paginated result set.
- searchstring
A search term.
Response
Example request
GET /api /environments /:project_id /warehouse_saved_queriesExample response
Status 200
Create environments warehouse saved queries
Required API key scopes
warehouse_view:writePath parameters
- project_idstring
Project ID of the project you're trying to access. To find the ID of the project, make a call to /api/projects/.
Request parameters
- deletedboolean
- namestring
- query
HogQL query
- edited_history_idstring
- soft_updateboolean
Response
Example request
POST /api /environments /:project_id /warehouse_saved_queriesExample response
Status 201
Create environments warehouse saved queries
Required API key scopes
warehouse_view:writePath parameters
- project_idstring
Project ID of the project you're trying to access. To find the ID of the project, make a call to /api/projects/.
Request parameters
- deletedboolean
- namestring
- query
HogQL query
- edited_history_idstring
- soft_updateboolean
Response
Example request
POST /api /environments /:project_id /warehouse_saved_queriesExample response
Status 201
Retrieve environments warehouse saved queries
Required API key scopes
warehouse_view:readPath parameters
- idstring
A UUID string identifying this data warehouse saved query.
- project_idstring
Project ID of the project you're trying to access. To find the ID of the project, make a call to /api/projects/.
Response
Example request
GET /api /environments /:project_id /warehouse_saved_queries /:idExample response
Status 200
Retrieve environments warehouse saved queries
Required API key scopes
warehouse_view:readPath parameters
- idstring
A UUID string identifying this data warehouse saved query.
- project_idstring
Project ID of the project you're trying to access. To find the ID of the project, make a call to /api/projects/.
Response
Example request
GET /api /environments /:project_id /warehouse_saved_queries /:idExample response
Status 200
Update environments warehouse saved queries
Required API key scopes
warehouse_view:writePath parameters
- idstring
A UUID string identifying this data warehouse saved query.
- project_idstring
Project ID of the project you're trying to access. To find the ID of the project, make a call to /api/projects/.
Request parameters
- deletedboolean
- namestring
- query
HogQL query
- edited_history_idstring
- soft_updateboolean
Response
Example request
PATCH /api /environments /:project_id /warehouse_saved_queries /:idExample response
Status 200
Update environments warehouse saved queries
Required API key scopes
warehouse_view:writePath parameters
- idstring
A UUID string identifying this data warehouse saved query.
- project_idstring
Project ID of the project you're trying to access. To find the ID of the project, make a call to /api/projects/.
Request parameters
- deletedboolean
- namestring
- query
HogQL query
- edited_history_idstring
- soft_updateboolean
Response
Example request
PATCH /api /environments /:project_id /warehouse_saved_queries /:idExample response
Status 200
Delete environments warehouse saved queries
Required API key scopes
warehouse_view:writePath parameters
- idstring
A UUID string identifying this data warehouse saved query.
- project_idstring
Project ID of the project you're trying to access. To find the ID of the project, make a call to /api/projects/.
Example request
DELETE /api /environments /:project_id /warehouse_saved_queries /:idExample response
Status 204 No response body
Delete environments warehouse saved queries
Required API key scopes
warehouse_view:writePath parameters
- idstring
A UUID string identifying this data warehouse saved query.
- project_idstring
Project ID of the project you're trying to access. To find the ID of the project, make a call to /api/projects/.
Example request
DELETE /api /environments /:project_id /warehouse_saved_queries /:idExample response
Status 204 No response body
Retrieve environments warehouse saved queries activity
Required API key scopes
activity_log:readPath parameters
- idstring
A UUID string identifying this data warehouse saved query.
- project_idstring
Project ID of the project you're trying to access. To find the ID of the project, make a call to /api/projects/.
Response
Example request
GET /api /environments /:project_id /warehouse_saved_queries /:id /activityExample response
Status 200
Retrieve environments warehouse saved queries activity
Required API key scopes
activity_log:readPath parameters
- idstring
A UUID string identifying this data warehouse saved query.
- project_idstring
Project ID of the project you're trying to access. To find the ID of the project, make a call to /api/projects/.
Response
Example request
GET /api /environments /:project_id /warehouse_saved_queries /:id /activityExample response
Status 200
Create environments warehouse saved queries ancestors
Return the ancestors of this saved query.
By default, we return the immediate parents. The level parameter can be used to
look further back into the ancestor tree. If level overshoots (i.e. points to only
ancestors beyond the root), we return an empty list.
Path parameters
- idstring
A UUID string identifying this data warehouse saved query.
- project_idstring
Project ID of the project you're trying to access. To find the ID of the project, make a call to /api/projects/.
Request parameters
- deletedboolean
- namestring
- query
HogQL query
- edited_history_idstring
- soft_updateboolean
Response
Example request
POST /api /environments /:project_id /warehouse_saved_queries /:id /ancestorsExample response
Status 200
Create environments warehouse saved queries ancestors
Return the ancestors of this saved query.
By default, we return the immediate parents. The level parameter can be used to
look further back into the ancestor tree. If level overshoots (i.e. points to only
ancestors beyond the root), we return an empty list.
Path parameters
- idstring
A UUID string identifying this data warehouse saved query.
- project_idstring
Project ID of the project you're trying to access. To find the ID of the project, make a call to /api/projects/.
Request parameters
- deletedboolean
- namestring
- query
HogQL query
- edited_history_idstring
- soft_updateboolean
Response
Example request
POST /api /environments /:project_id /warehouse_saved_queries /:id /ancestorsExample response
Status 200
Create environments warehouse saved queries cancel
Cancel a running saved query workflow.
Path parameters
- idstring
A UUID string identifying this data warehouse saved query.
- project_idstring
Project ID of the project you're trying to access. To find the ID of the project, make a call to /api/projects/.
Request parameters
- deletedboolean
- namestring
- query
HogQL query
- edited_history_idstring
- soft_updateboolean
Response
Example request
POST /api /environments /:project_id /warehouse_saved_queries /:id /cancelExample response
Status 200
Create environments warehouse saved queries cancel
Cancel a running saved query workflow.
Path parameters
- idstring
A UUID string identifying this data warehouse saved query.
- project_idstring
Project ID of the project you're trying to access. To find the ID of the project, make a call to /api/projects/.
Request parameters
- deletedboolean
- namestring
- query
HogQL query
- edited_history_idstring
- soft_updateboolean
Response
Example request
POST /api /environments /:project_id /warehouse_saved_queries /:id /cancelExample response
Status 200
Retrieve environments warehouse saved queries dependencies
Return the count of immediate upstream and downstream dependencies for this saved query.
Path parameters
- idstring
A UUID string identifying this data warehouse saved query.
- project_idstring
Project ID of the project you're trying to access. To find the ID of the project, make a call to /api/projects/.
Response
Example request
GET /api /environments /:project_id /warehouse_saved_queries /:id /dependenciesExample response
Status 200
Retrieve environments warehouse saved queries dependencies
Return the count of immediate upstream and downstream dependencies for this saved query.
Path parameters
- idstring
A UUID string identifying this data warehouse saved query.
- project_idstring
Project ID of the project you're trying to access. To find the ID of the project, make a call to /api/projects/.
Response
Example request
GET /api /environments /:project_id /warehouse_saved_queries /:id /dependencies