naftiko: 1.0.0-alpha2
info:
  label: PostHog API — warehouse_saved_queries
  description: 'PostHog API — warehouse_saved_queries. 32 operations. Lead operation: warehouse_saved_queries. Self-contained
    Naftiko capability covering one Posthog business surface.'
  tags:
  - Posthog
  - warehouse_saved_queries
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    POSTHOG_API_KEY: POSTHOG_API_KEY
capability:
  consumes:
  - type: http
    namespace: posthog-warehouse-saved-queries
    baseUri: ''
    description: PostHog API — warehouse_saved_queries business capability. Self-contained, no shared references.
    resources:
    - name: api-environments-environment_id-warehouse_saved_queries
      path: /api/environments/{environment_id}/warehouse_saved_queries/
      operations:
      - name: environmentswarehousesavedquerieslist
        method: GET
        description: Create, Read, Update and Delete Warehouse Tables.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: page
          in: query
          type: integer
          description: A page number within the paginated result set.
        - name: search
          in: query
          type: string
          description: A search term.
      - name: environmentswarehousesavedqueriescreate
        method: POST
        description: Create, Read, Update and Delete Warehouse Tables.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: api-environments-environment_id-warehouse_saved_queries-resume_schedules
      path: /api/environments/{environment_id}/warehouse_saved_queries/resume_schedules/
      operations:
      - name: environmentswarehousesavedqueriesresumeschedulescreate
        method: POST
        description: Resume paused materialization schedules for multiple matviews.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: api-environments-environment_id-warehouse_saved_queries-id
      path: /api/environments/{environment_id}/warehouse_saved_queries/{id}/
      operations:
      - name: environmentswarehousesavedqueriesretrieve
        method: GET
        description: Create, Read, Update and Delete Warehouse Tables.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: A UUID string identifying this data warehouse saved query.
          required: true
      - name: environmentswarehousesavedqueriesupdate
        method: PUT
        description: Create, Read, Update and Delete Warehouse Tables.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: A UUID string identifying this data warehouse saved query.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
      - name: environmentswarehousesavedqueriespartialupdate
        method: PATCH
        description: Create, Read, Update and Delete Warehouse Tables.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: A UUID string identifying this data warehouse saved query.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
      - name: environmentswarehousesavedqueriesdestroy
        method: DELETE
        description: Create, Read, Update and Delete Warehouse Tables.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: A UUID string identifying this data warehouse saved query.
          required: true
    - name: api-environments-environment_id-warehouse_saved_queries-id-activity
      path: /api/environments/{environment_id}/warehouse_saved_queries/{id}/activity/
      operations:
      - name: environmentswarehousesavedqueriesactivityretrieve
        method: GET
        description: Create, Read, Update and Delete Warehouse Tables.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: A UUID string identifying this data warehouse saved query.
          required: true
    - name: api-environments-environment_id-warehouse_saved_queries-id-ancestors
      path: /api/environments/{environment_id}/warehouse_saved_queries/{id}/ancestors/
      operations:
      - name: environmentswarehousesavedqueriesancestorscreate
        method: POST
        description: Return the ancestors of this saved query.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: A UUID string identifying this data warehouse saved query.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: api-environments-environment_id-warehouse_saved_queries-id-cancel
      path: /api/environments/{environment_id}/warehouse_saved_queries/{id}/cancel/
      operations:
      - name: environmentswarehousesavedqueriescancelcreate
        method: POST
        description: Cancel a running saved query workflow.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: A UUID string identifying this data warehouse saved query.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: api-environments-environment_id-warehouse_saved_queries-id-dependencies
      path: /api/environments/{environment_id}/warehouse_saved_queries/{id}/dependencies/
      operations:
      - name: environmentswarehousesavedqueriesdependenciesretrieve
        method: GET
        description: Return the count of immediate upstream and downstream dependencies for this saved query.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: A UUID string identifying this data warehouse saved query.
          required: true
    - name: api-environments-environment_id-warehouse_saved_queries-id-descendants
      path: /api/environments/{environment_id}/warehouse_saved_queries/{id}/descendants/
      operations:
      - name: environmentswarehousesavedqueriesdescendantscreate
        method: POST
        description: Return the descendants of this saved query.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: A UUID string identifying this data warehouse saved query.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: api-environments-environment_id-warehouse_saved_queries-id-materialize
      path: /api/environments/{environment_id}/warehouse_saved_queries/{id}/materialize/
      operations:
      - name: environmentswarehousesavedqueriesmaterializecreate
        method: POST
        description: Enable materialization for this saved query with a 24-hour sync frequency.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: A UUID string identifying this data warehouse saved query.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: api-environments-environment_id-warehouse_saved_queries-id-revert_materializatio
      path: /api/environments/{environment_id}/warehouse_saved_queries/{id}/revert_materialization/
      operations:
      - name: environmentswarehousesavedqueriesrevertmaterializationcreate
        method: POST
        description: Undo materialization, revert back to the original view.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: A UUID string identifying this data warehouse saved query.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: api-environments-environment_id-warehouse_saved_queries-id-run
      path: /api/environments/{environment_id}/warehouse_saved_queries/{id}/run/
      operations:
      - name: environmentswarehousesavedqueriesruncreate
        method: POST
        description: Run this saved query.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: A UUID string identifying this data warehouse saved query.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: api-environments-environment_id-warehouse_saved_queries-id-run_history
      path: /api/environments/{environment_id}/warehouse_saved_queries/{id}/run_history/
      operations:
      - name: environmentswarehousesavedqueriesrunhistoryretrieve
        method: GET
        description: Return the recent run history (up to 5 most recent) for this materialized view.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: A UUID string identifying this data warehouse saved query.
          required: true
    - name: api-projects-project_id-warehouse_saved_queries
      path: /api/projects/{project_id}/warehouse_saved_queries/
      operations:
      - name: warehousesavedquerieslist
        method: GET
        description: Create, Read, Update and Delete Warehouse Tables.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: page
          in: query
          type: integer
          description: A page number within the paginated result set.
        - name: search
          in: query
          type: string
          description: A search term.
      - name: warehousesavedqueriescreate
        method: POST
        description: Create, Read, Update and Delete Warehouse Tables.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: api-projects-project_id-warehouse_saved_queries-resume_schedules
      path: /api/projects/{project_id}/warehouse_saved_queries/resume_schedules/
      operations:
      - name: warehousesavedqueriesresumeschedulescreate
        method: POST
        description: Resume paused materialization schedules for multiple matviews.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: api-projects-project_id-warehouse_saved_queries-id
      path: /api/projects/{project_id}/warehouse_saved_queries/{id}/
      operations:
      - name: warehousesavedqueriesretrieve
        method: GET
        description: Create, Read, Update and Delete Warehouse Tables.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: A UUID string identifying this data warehouse saved query.
          required: true
      - name: warehousesavedqueriesupdate
        method: PUT
        description: Create, Read, Update and Delete Warehouse Tables.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: A UUID string identifying this data warehouse saved query.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
      - name: warehousesavedqueriespartialupdate
        method: PATCH
        description: Create, Read, Update and Delete Warehouse Tables.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: A UUID string identifying this data warehouse saved query.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
      - name: warehousesavedqueriesdestroy
        method: DELETE
        description: Create, Read, Update and Delete Warehouse Tables.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: A UUID string identifying this data warehouse saved query.
          required: true
    - name: api-projects-project_id-warehouse_saved_queries-id-activity
      path: /api/projects/{project_id}/warehouse_saved_queries/{id}/activity/
      operations:
      - name: warehousesavedqueriesactivityretrieve
        method: GET
        description: Create, Read, Update and Delete Warehouse Tables.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: A UUID string identifying this data warehouse saved query.
          required: true
    - name: api-projects-project_id-warehouse_saved_queries-id-ancestors
      path: /api/projects/{project_id}/warehouse_saved_queries/{id}/ancestors/
      operations:
      - name: warehousesavedqueriesancestorscreate
        method: POST
        description: Return the ancestors of this saved query.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: A UUID string identifying this data warehouse saved query.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: api-projects-project_id-warehouse_saved_queries-id-cancel
      path: /api/projects/{project_id}/warehouse_saved_queries/{id}/cancel/
      operations:
      - name: warehousesavedqueriescancelcreate
        method: POST
        description: Cancel a running saved query workflow.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: A UUID string identifying this data warehouse saved query.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: api-projects-project_id-warehouse_saved_queries-id-dependencies
      path: /api/projects/{project_id}/warehouse_saved_queries/{id}/dependencies/
      operations:
      - name: warehousesavedqueriesdependenciesretrieve
        method: GET
        description: Return the count of immediate upstream and downstream dependencies for this saved query.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: A UUID string identifying this data warehouse saved query.
          required: true
    - name: api-projects-project_id-warehouse_saved_queries-id-descendants
      path: /api/projects/{project_id}/warehouse_saved_queries/{id}/descendants/
      operations:
      - name: warehousesavedqueriesdescendantscreate
        method: POST
        description: Return the descendants of this saved query.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: A UUID string identifying this data warehouse saved query.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: api-projects-project_id-warehouse_saved_queries-id-materialize
      path: /api/projects/{project_id}/warehouse_saved_queries/{id}/materialize/
      operations:
      - name: warehousesavedqueriesmaterializecreate
        method: POST
        description: Enable materialization for this saved query with a 24-hour sync frequency.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: A UUID string identifying this data warehouse saved query.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: api-projects-project_id-warehouse_saved_queries-id-revert_materialization
      path: /api/projects/{project_id}/warehouse_saved_queries/{id}/revert_materialization/
      operations:
      - name: warehousesavedqueriesrevertmaterializationcreate
        method: POST
        description: Undo materialization, revert back to the original view.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: A UUID string identifying this data warehouse saved query.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: api-projects-project_id-warehouse_saved_queries-id-run
      path: /api/projects/{project_id}/warehouse_saved_queries/{id}/run/
      operations:
      - name: warehousesavedqueriesruncreate
        method: POST
        description: Run this saved query.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: A UUID string identifying this data warehouse saved query.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: api-projects-project_id-warehouse_saved_queries-id-run_history
      path: /api/projects/{project_id}/warehouse_saved_queries/{id}/run_history/
      operations:
      - name: warehousesavedqueriesrunhistoryretrieve
        method: GET
        description: Return the recent run history (up to 5 most recent) for this materialized view.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: A UUID string identifying this data warehouse saved query.
          required: true
    authentication:
      type: bearer
      token: '{{env.POSTHOG_API_KEY}}'
  exposes:
  - type: rest
    namespace: posthog-warehouse-saved-queries-rest
    port: 8080
    description: REST adapter for PostHog API — warehouse_saved_queries. One Spectral-compliant resource per consumed operation,
      prefixed with /v1.
    resources:
    - path: /v1/api/environments/{environment-id}/warehouse-saved-queries
      name: api-environments-environment-id-warehouse-saved-queries
      description: REST surface for api-environments-environment_id-warehouse_saved_queries.
      operations:
      - method: GET
        name: environmentswarehousesavedquerieslist
        description: Create, Read, Update and Delete Warehouse Tables.
        call: posthog-warehouse-saved-queries.environmentswarehousesavedquerieslist
        with:
          page: rest.page
          search: rest.search
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: environmentswarehousesavedqueriescreate
        description: Create, Read, Update and Delete Warehouse Tables.
        call: posthog-warehouse-saved-queries.environmentswarehousesavedqueriescreate
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/environments/{environment-id}/warehouse-saved-queries/resume-schedules
      name: api-environments-environment-id-warehouse-saved-queries-resume-schedules
      description: REST surface for api-environments-environment_id-warehouse_saved_queries-resume_schedules.
      operations:
      - method: POST
        name: environmentswarehousesavedqueriesresumeschedulescreate
        description: Resume paused materialization schedules for multiple matviews.
        call: posthog-warehouse-saved-queries.environmentswarehousesavedqueriesresumeschedulescreate
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/environments/{environment-id}/warehouse-saved-queries/{id}
      name: api-environments-environment-id-warehouse-saved-queries-id
      description: REST surface for api-environments-environment_id-warehouse_saved_queries-id.
      operations:
      - method: GET
        name: environmentswarehousesavedqueriesretrieve
        description: Create, Read, Update and Delete Warehouse Tables.
        call: posthog-warehouse-saved-queries.environmentswarehousesavedqueriesretrieve
        with:
          id: rest.id
        outputParameters:
        - type: object
          mapping: $.
      - method: PUT
        name: environmentswarehousesavedqueriesupdate
        description: Create, Read, Update and Delete Warehouse Tables.
        call: posthog-warehouse-saved-queries.environmentswarehousesavedqueriesupdate
        with:
          id: rest.id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: PATCH
        name: environmentswarehousesavedqueriespartialupdate
        description: Create, Read, Update and Delete Warehouse Tables.
        call: posthog-warehouse-saved-queries.environmentswarehousesavedqueriespartialupdate
        with:
          id: rest.id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: DELETE
        name: environmentswarehousesavedqueriesdestroy
        description: Create, Read, Update and Delete Warehouse Tables.
        call: posthog-warehouse-saved-queries.environmentswarehousesavedqueriesdestroy
        with:
          id: rest.id
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/environments/{environment-id}/warehouse-saved-queries/{id}/activity
      name: api-environments-environment-id-warehouse-saved-queries-id-activity
      description: REST surface for api-environments-environment_id-warehouse_saved_queries-id-activity.
      operations:
      - method: GET
        name: environmentswarehousesavedqueriesactivityretrieve
        description: Create, Read, Update and Delete Warehouse Tables.
        call: posthog-warehouse-saved-queries.environmentswarehousesavedqueriesactivityretrieve
        with:
          id: rest.id
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/environments/{environment-id}/warehouse-saved-queries/{id}/ancestors
      name: api-environments-environment-id-warehouse-saved-queries-id-ancestors
      description: REST surface for api-environments-environment_id-warehouse_saved_queries-id-ancestors.
      operations:
      - method: POST
        name: environmentswarehousesavedqueriesancestorscreate
        description: Return the ancestors of this saved query.
        call: posthog-warehouse-saved-queries.environmentswarehousesavedqueriesancestorscreate
        with:
          id: rest.id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/environments/{environment-id}/warehouse-saved-queries/{id}/cancel
      name: api-environments-environment-id-warehouse-saved-queries-id-cancel
      description: REST surface for api-environments-environment_id-warehouse_saved_queries-id-cancel.
      operations:
      - method: POST
        name: environmentswarehousesavedqueriescancelcreate
        description: Cancel a running saved query workflow.
        call: posthog-warehouse-saved-queries.environmentswarehousesavedqueriescancelcreate
        with:
          id: rest.id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/environments/{environment-id}/warehouse-saved-queries/{id}/dependencies
      name: api-environments-environment-id-warehouse-saved-queries-id-dependencies
      description: REST surface for api-environments-environment_id-warehouse_saved_queries-id-dependencies.
      operations:
      - method: GET
        name: environmentswarehousesavedqueriesdependenciesretrieve
        description: Return the count of immediate upstream and downstream dependencies for this saved query.
        call: posthog-warehouse-saved-queries.environmentswarehousesavedqueriesdependenciesretrieve
        with:
          id: rest.id
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/environments/{environment-id}/warehouse-saved-queries/{id}/descendants
      name: api-environments-environment-id-warehouse-saved-queries-id-descendants
      description: REST surface for api-environments-environment_id-warehouse_saved_queries-id-descendants.
      operations:
      - method: POST
        name: environmentswarehousesavedqueriesdescendantscreate
        description: Return the descendants of this saved query.
        call: posthog-warehouse-saved-queries.environmentswarehousesavedqueriesdescendantscreate
        with:
          id: rest.id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/environments/{environment-id}/warehouse-saved-queries/{id}/materialize
      name: api-environments-environment-id-warehouse-saved-queries-id-materialize
      description: REST surface for api-environments-environment_id-warehouse_saved_queries-id-materialize.
      operations:
      - method: POST
        name: environmentswarehousesavedqueriesmaterializecreate
        description: Enable materialization for this saved query with a 24-hour sync frequency.
        call: posthog-warehouse-saved-queries.environmentswarehousesavedqueriesmaterializecreate
        with:
          id: rest.id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/environments/{environment-id}/warehouse-saved-queries/{id}/revert-materialization
      name: api-environments-environment-id-warehouse-saved-queries-id-revert-materializatio
      description: REST surface for api-environments-environment_id-warehouse_saved_queries-id-revert_materializatio.
      operations:
      - method: POST
        name: environmentswarehousesavedqueriesrevertmaterializationcreate
        description: Undo materialization, revert back to the original view.
        call: posthog-warehouse-saved-queries.environmentswarehousesavedqueriesrevertmaterializationcreate
        with:
          id: rest.id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/environments/{environment-id}/warehouse-saved-queries/{id}/run
      name: api-environments-environment-id-warehouse-saved-queries-id-run
      description: REST surface for api-environments-environment_id-warehouse_saved_queries-id-run.
      operations:
      - method: POST
        name: environmentswarehousesavedqueriesruncreate
        description: Run this saved query.
        call: posthog-warehouse-saved-queries.environmentswarehousesavedqueriesruncreate
        with:
          id: rest.id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/environments/{environment-id}/warehouse-saved-queries/{id}/run-history
      name: api-environments-environment-id-warehouse-saved-queries-id-run-history
      description: REST surface for api-environments-environment_id-warehouse_saved_queries-id-run_history.
      operations:
      - method: GET
        name: environmentswarehousesavedqueriesrunhistoryretrieve
        description: Return the recent run history (up to 5 most recent) for this materialized view.
        call: posthog-warehouse-saved-queries.environmentswarehousesavedqueriesrunhistoryretrieve
        with:
          id: rest.id
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/projects/{project-id}/warehouse-saved-queries
      name: api-projects-project-id-warehouse-saved-queries
      description: REST surface for api-projects-project_id-warehouse_saved_queries.
      operations:
      - method: GET
        name: warehousesavedquerieslist
        description: Create, Read, Update and Delete Warehouse Tables.
        call: posthog-warehouse-saved-queries.warehousesavedquerieslist
        with:
          page: rest.page
          search: rest.search
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: warehousesavedqueriescreate
        description: Create, Read, Update and Delete Warehouse Tables.
        call: posthog-warehouse-saved-queries.warehousesavedqueriescreate
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/projects/{project-id}/warehouse-saved-queries/resume-schedules
      name: api-projects-project-id-warehouse-saved-queries-resume-schedules
      description: REST surface for api-projects-project_id-warehouse_saved_queries-resume_schedules.
      operations:
      - method: POST
        name: warehousesavedqueriesresumeschedulescreate
        description: Resume paused materialization schedules for multiple matviews.
        call: posthog-warehouse-saved-queries.warehousesavedqueriesresumeschedulescreate
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/projects/{project-id}/warehouse-saved-queries/{id}
      name: api-projects-project-id-warehouse-saved-queries-id
      description: REST surface for api-projects-project_id-warehouse_saved_queries-id.
      operations:
      - method: GET
        name: warehousesavedqueriesretrieve
        description: Create, Read, Update and Delete Warehouse Tables.
        call: posthog-warehouse-saved-queries.warehousesavedqueriesretrieve
        with:
          id: rest.id
        outputParameters:
        - type: object
          mapping: $.
      - method: PUT
        name: warehousesavedqueriesupdate
        description: Create, Read, Update and Delete Warehouse Tables.
        call: posthog-warehouse-saved-queries.warehousesavedqueriesupdate
        with:
          id: rest.id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: PATCH
        name: warehousesavedqueriespartialupdate
        description: Create, Read, Update and Delete Warehouse Tables.
        call: posthog-warehouse-saved-queries.warehousesavedqueriespartialupdate
        with:
          id: rest.id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: DELETE
        name: warehousesavedqueriesdestroy
        description: Create, Read, Update and Delete Warehouse Tables.
        call: posthog-warehouse-saved-queries.warehousesavedqueriesdestroy
        with:
          id: rest.id
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/projects/{project-id}/warehouse-saved-queries/{id}/activity
      name: api-projects-project-id-warehouse-saved-queries-id-activity
      description: REST surface for api-projects-project_id-warehouse_saved_queries-id-activity.
      operations:
      - method: GET
        name: warehousesavedqueriesactivityretrieve
        description: Create, Read, Update and Delete Warehouse Tables.
        call: posthog-warehouse-saved-queries.warehousesavedqueriesactivityretrieve
        with:
          id: rest.id
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/projects/{project-id}/warehouse-saved-queries/{id}/ancestors
      name: api-projects-project-id-warehouse-saved-queries-id-ancestors
      description: REST surface for api-projects-project_id-warehouse_saved_queries-id-ancestors.
      operations:
      - method: POST
        name: warehousesavedqueriesancestorscreate
        description: Return the ancestors of this saved query.
        call: posthog-warehouse-saved-queries.warehousesavedqueriesancestorscreate
        with:
          id: rest.id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/projects/{project-id}/warehouse-saved-queries/{id}/cancel
      name: api-projects-project-id-warehouse-saved-queries-id-cancel
      description: REST surface for api-projects-project_id-warehouse_saved_queries-id-cancel.
      operations:
      - method: POST
        name: warehousesavedqueriescancelcreate
        description: Cancel a running saved query workflow.
        call: posthog-warehouse-saved-queries.warehousesavedqueriescancelcreate
        with:
          id: rest.id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/projects/{project-id}/warehouse-saved-queries/{id}/dependencies
      name: api-projects-project-id-warehouse-saved-queries-id-dependencies
      description: REST surface for api-projects-project_id-warehouse_saved_queries-id-dependencies.
      operations:
      - method: GET
        name: warehousesavedqueriesdependenciesretrieve
        description: Return the count of immediate upstream and downstream dependencies for this saved query.
        call: posthog-warehouse-saved-queries.warehousesavedqueriesdependenciesretrieve
        with:
          id: rest.id
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/projects/{project-id}/warehouse-saved-queries/{id}/descendants
      name: api-projects-project-id-warehouse-saved-queries-id-descendants
      description: REST surface for api-projects-project_id-warehouse_saved_queries-id-descendants.
      operations:
      - method: POST
        name: warehousesavedqueriesdescendantscreate
        description: Return the descendants of this saved query.
        call: posthog-warehouse-saved-queries.warehousesavedqueriesdescendantscreate
        with:
          id: rest.id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/projects/{project-id}/warehouse-saved-queries/{id}/materialize
      name: api-projects-project-id-warehouse-saved-queries-id-materialize
      description: REST surface for api-projects-project_id-warehouse_saved_queries-id-materialize.
      operations:
      - method: POST
        name: warehousesavedqueriesmaterializecreate
        description: Enable materialization for this saved query with a 24-hour sync frequency.
        call: posthog-warehouse-saved-queries.warehousesavedqueriesmaterializecreate
        with:
          id: rest.id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/projects/{project-id}/warehouse-saved-queries/{id}/revert-materialization
      name: api-projects-project-id-warehouse-saved-queries-id-revert-materialization
      description: REST surface for api-projects-project_id-warehouse_saved_queries-id-revert_materialization.
      operations:
      - method: POST
        name: warehousesavedqueriesrevertmaterializationcreate
        description: Undo materialization, revert back to the original view.
        call: posthog-warehouse-saved-queries.warehousesavedqueriesrevertmaterializationcreate
        with:
          id: rest.id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/projects/{project-id}/warehouse-saved-queries/{id}/run
      name: api-projects-project-id-warehouse-saved-queries-id-run
      description: REST surface for api-projects-project_id-warehouse_saved_queries-id-run.
      operations:
      - method: POST
        name: warehousesavedqueriesruncreate
        description: Run this saved query.
        call: posthog-warehouse-saved-queries.warehousesavedqueriesruncreate
        with:
          id: rest.id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/projects/{project-id}/warehouse-saved-queries/{id}/run-history
      name: api-projects-project-id-warehouse-saved-queries-id-run-history
      description: REST surface for api-projects-project_id-warehouse_saved_queries-id-run_history.
      operations:
      - method: GET
        name: warehousesavedqueriesrunhistoryretrieve
        description: Return the recent run history (up to 5 most recent) for this materialized view.
        call: posthog-warehouse-saved-queries.warehousesavedqueriesrunhistoryretrieve
        with:
          id: rest.id
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: posthog-warehouse-saved-queries-mcp
    port: 9090
    transport: http
    description: MCP adapter for PostHog API — warehouse_saved_queries. One tool per consumed operation, routed inline through
      this capability's consumes block.
    tools:
    - name: create-read-update-and-delete
      description: Create, Read, Update and Delete Warehouse Tables.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: posthog-warehouse-saved-queries.environmentswarehousesavedquerieslist
      with:
        page: tools.page
        search: tools.search
      outputParameters:
      - type: object
        mapping: $.
    - name: create-read-update-and-delete-2
      description: Create, Read, Update and Delete Warehouse Tables.
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: posthog-warehouse-saved-queries.environmentswarehousesavedqueriescreate
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: resume-paused-materialization-schedules-multiple
      description: Resume paused materialization schedules for multiple matviews.
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: posthog-warehouse-saved-queries.environmentswarehousesavedqueriesresumeschedulescreate
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: create-read-update-and-delete-3
      description: Create, Read, Update and Delete Warehouse Tables.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: posthog-warehouse-saved-queries.environmentswarehousesavedqueriesretrieve
      with:
        id: tools.id
      outputParameters:
      - type: object
        mapping: $.
    - name: create-read-update-and-delete-4
      description: Create, Read, Update and Delete Warehouse Tables.
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: posthog-warehouse-saved-queries.environmentswarehousesavedqueriesupdate
      with:
        id: tools.id
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: create-read-update-and-delete-5
      description: Create, Read, Update and Delete Warehouse Tables.
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: posthog-warehouse-saved-queries.environmentswarehousesavedqueriespartialupdate
      with:
        id: tools.id
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: create-read-update-and-delete-6
      description: Create, Read, Update and Delete Warehouse Tables.
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: posthog-warehouse-saved-queries.environmentswarehousesavedqueriesdestroy
      with:
        id: tools.id
      outputParameters:
      - type: object
        mapping: $.
    - name: create-read-update-and-delete-7
      description: Create, Read, Update and Delete Warehouse Tables.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: posthog-warehouse-saved-queries.environmentswarehousesavedqueriesactivityretrieve
      with:
        id: tools.id
      outputParameters:
      - type: object
        mapping: $.
    - name: return-ancestors-this-saved-query
      description: Return the ancestors of this saved query.
      hints:
        readOnly: true
        destructive: false
        idempotent: false
      call: posthog-warehouse-saved-queries.environmentswarehousesavedqueriesancestorscreate
      with:
        id: tools.id
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: cancel-running-saved-query-workflow
      description: Cancel a running saved query workflow.
      hints:
        readOnly: true
        destructive: false
        idempotent: false
      call: posthog-warehouse-saved-queries.environmentswarehousesavedqueriescancelcreate
      with:
        id: tools.id
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: return-count-immediate-upstream-and
      description: Return the count of immediate upstream and downstream dependencies for this saved query.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: posthog-warehouse-saved-queries.environmentswarehousesavedqueriesdependenciesretrieve
      with:
        id: tools.id
      outputParameters:
      - type: object
        mapping: $.
    - name: return-descendants-this-saved-query
      description: Return the descendants of this saved query.
      hints:
        readOnly: true
        destructive: false
        idempotent: false
      call: posthog-warehouse-saved-queries.environmentswarehousesavedqueriesdescendantscreate
      with:
        id: tools.id
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: enable-materialization-this-saved-query
      description: Enable materialization for this saved query with a 24-hour sync frequency.
      hints:
        readOnly: true
        destructive: false
        idempotent: false
      call: posthog-warehouse-saved-queries.environmentswarehousesavedqueriesmaterializecreate
      with:
        id: tools.id
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: undo-materialization-revert-back-original
      description: Undo materialization, revert back to the original view.
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: posthog-warehouse-saved-queries.environmentswarehousesavedqueriesrevertmaterializationcreate
      with:
        id: tools.id
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: run-this-saved-query
      description: Run this saved query.
      hints:
        readOnly: true
        destructive: false
        idempotent: false
      call: posthog-warehouse-saved-queries.environmentswarehousesavedqueriesruncreate
      with:
        id: tools.id
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: return-recent-run-history-up
      description: Return the recent run history (up to 5 most recent) for this materialized view.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: posthog-warehouse-saved-queries.environmentswarehousesavedqueriesrunhistoryretrieve
      with:
        id: tools.id
      outputParameters:
      - type: object
        mapping: $.
    - name: create-read-update-and-delete-8
      description: Create, Read, Update and Delete Warehouse Tables.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: posthog-warehouse-saved-queries.warehousesavedquerieslist
      with:
        page: tools.page
        search: tools.search
      outputParameters:
      - type: object
        mapping: $.
    - name: create-read-update-and-delete-9
      description: Create, Read, Update and Delete Warehouse Tables.
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: posthog-warehouse-saved-queries.warehousesavedqueriescreate
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: resume-paused-materialization-schedules-multiple-2
      description: Resume paused materialization schedules for multiple matviews.
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: posthog-warehouse-saved-queries.warehousesavedqueriesresumeschedulescreate
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: create-read-update-and-delete-10
      description: Create, Read, Update and Delete Warehouse Tables.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: posthog-warehouse-saved-queries.warehousesavedqueriesretrieve
      with:
        id: tools.id
      outputParameters:
      - type: object
        mapping: $.
    - name: create-read-update-and-delete-11
      description: Create, Read, Update and Delete Warehouse Tables.
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: posthog-warehouse-saved-queries.warehousesavedqueriesupdate
      with:
        id: tools.id
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: create-read-update-and-delete-12
      description: Create, Read, Update and Delete Warehouse Tables.
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: posthog-warehouse-saved-queries.warehousesavedqueriespartialupdate
      with:
        id: tools.id
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: create-read-update-and-delete-13
      description: Create, Read, Update and Delete Warehouse Tables.
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: posthog-warehouse-saved-queries.warehousesavedqueriesdestroy
      with:
        id: tools.id
      outputParameters:
      - type: object
        mapping: $.
    - name: create-read-update-and-delete-14
      description: Create, Read, Update and Delete Warehouse Tables.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: posthog-warehouse-saved-queries.warehousesavedqueriesactivityretrieve
      with:
        id: tools.id
      outputParameters:
      - type: object
        mapping: $.
    - name: return-ancestors-this-saved-query-2
      description: Return the ancestors of this saved query.
      hints:
        readOnly: true
        destructive: false
        idempotent: false
      call: posthog-warehouse-saved-queries.warehousesavedqueriesancestorscreate
      with:
        id: tools.id
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: cancel-running-saved-query-workflow-2
      description: Cancel a running saved query workflow.
      hints:
        readOnly: true
        destructive: false
        idempotent: false
      call: posthog-warehouse-saved-queries.warehousesavedqueriescancelcreate
      with:
        id: tools.id
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: return-count-immediate-upstream-and-2
      description: Return the count of immediate upstream and downstream dependencies for this saved query.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: posthog-warehouse-saved-queries.warehousesavedqueriesdependenciesretrieve
      with:
        id: tools.id
      outputParameters:
      - type: object
        mapping: $.
    - name: return-descendants-this-saved-query-2
      description: Return the descendants of this saved query.
      hints:
        readOnly: true
        destructive: false
        idempotent: false
      call: posthog-warehouse-saved-queries.warehousesavedqueriesdescendantscreate
      with:
        id: tools.id
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: enable-materialization-this-saved-query-2
      description: Enable materialization for this saved query with a 24-hour sync frequency.
      hints:
        readOnly: true
        destructive: false
        idempotent: false
      call: posthog-warehouse-saved-queries.warehousesavedqueriesmaterializecreate
      with:
        id: tools.id
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: undo-materialization-revert-back-original-2
      description: Undo materialization, revert back to the original view.
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: posthog-warehouse-saved-queries.warehousesavedqueriesrevertmaterializationcreate
      with:
        id: tools.id
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: run-this-saved-query-2
      description: Run this saved query.
      hints:
        readOnly: true
        destructive: false
        idempotent: false
      call: posthog-warehouse-saved-queries.warehousesavedqueriesruncreate
      with:
        id: tools.id
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: return-recent-run-history-up-2
      description: Return the recent run history (up to 5 most recent) for this materialized view.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: posthog-warehouse-saved-queries.warehousesavedqueriesrunhistoryretrieve
      with:
        id: tools.id
      outputParameters:
      - type: object
        mapping: $.