API Evangelist conversational phrasing for Clickup Views API

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Clickup Views API
  version: 1.0.0
extends: openapi/clickup-views-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-09-26'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 20
- target: $.paths['/v2/team/{team_id}/view'].get
  update:
    x-apievangelist-phrasing:
      intent: List Everything-level views (v2)
      effect: read
      questions:
      - Which views live at the Everything level of my ClickUp Workspace?
      - Can I see the Workspace-wide task and page views through the v2 API?
      instructions:
      - text: List the Everything-level views in Workspace {team_id} via v2.
        slots:
          team_id: path.team_id
      - text: Show all task and page views pinned at the top of Workspace {team_id}.
        slots:
          team_id: path.team_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/team/{team_id}/view'].post
  update:
    x-apievangelist-phrasing:
      intent: Create an Everything-level view
      effect: write
      questions:
      - Can I add a Gantt or Workload view that spans the entire Workspace?
      - What settings must I pass when creating a Workspace-wide view?
      instructions:
      - text: Create a {type} view named {name} at the Everything level of Workspace {team_id}.
        slots:
          type: requestBody.type
          name: requestBody.name
          team_id: path.team_id
      - text: Add a Workspace-wide board called {name} to {team_id} grouped by {grouping} and filtered by {filters}.
        slots:
          name: requestBody.name
          team_id: path.team_id
          grouping: requestBody.grouping
          filters: requestBody.filters
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/space/{space_id}/view'].get
  update:
    x-apievangelist-phrasing:
      intent: List a Space's views (v2)
      effect: read
      questions:
      - What board, list and calendar views are set up on a given Space?
      - How do I see the views attached to one Space through v2?
      instructions:
      - text: List the v2 views on Space {space_id}.
        slots:
          space_id: path.space_id
      - text: Show every task and page view configured for Space {space_id}.
        slots:
          space_id: path.space_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/space/{space_id}/view'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a view to a Space
      effect: write
      questions:
      - Can I add a Calendar or Timeline view to a Space programmatically?
      - Which view types can be created on a Space?
      instructions:
      - text: Add a {type} view named {name} to Space {space_id}.
        slots:
          type: requestBody.type
          name: requestBody.name
          space_id: path.space_id
      - text: Create a Space view {name} on {space_id} sorted by {sorting} with columns {columns}.
        slots:
          name: requestBody.name
          space_id: path.space_id
          sorting: requestBody.sorting
          columns: requestBody.columns
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/folder/{folder_id}/view'].get
  update:
    x-apievangelist-phrasing:
      intent: List a Folder's views (v2)
      effect: read
      questions:
      - What views does a particular Folder have?
      - Can the v2 API show me the page and task views on one Folder?
      instructions:
      - text: List the v2 views on Folder {folder_id}.
        slots:
          folder_id: path.folder_id
      - text: Show the board, table and calendar views inside Folder {folder_id}.
        slots:
          folder_id: path.folder_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/folder/{folder_id}/view'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a view to a Folder
      effect: write
      questions:
      - Can I add a Table view to a Folder with specific columns?
      - What does it take to create a Map or Activity view on a Folder?
      instructions:
      - text: Add a {type} view called {name} to Folder {folder_id}.
        slots:
          type: requestBody.type
          name: requestBody.name
          folder_id: path.folder_id
      - text: Create Folder view {name} on {folder_id} divided by {divide} and filtered with {filters}.
        slots:
          name: requestBody.name
          folder_id: path.folder_id
          divide: requestBody.divide
          filters: requestBody.filters
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/list/{list_id}/view'].get
  update:
    x-apievangelist-phrasing:
      intent: List a List's views (v2)
      effect: read
      questions:
      - Which views exist on a single List, including the required ones?
      - Does the v2 List views response separate required views from the rest?
      instructions:
      - text: List the v2 views on List {list_id}, including required views.
        slots:
          list_id: path.list_id
      - text: Show what views are configured for List {list_id}.
        slots:
          list_id: path.list_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/list/{list_id}/view'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a view to a List
      effect: write
      questions:
      - Can I add a Board view to one List with my own grouping?
      - Is there a way to create a Gantt view scoped to a single List?
      instructions:
      - text: Add a {type} view named {name} to List {list_id}.
        slots:
          type: requestBody.type
          name: requestBody.name
          list_id: path.list_id
      - text: Create a List view {name} on {list_id} grouped by {grouping} with settings {settings}.
        slots:
          name: requestBody.name
          list_id: path.list_id
          grouping: requestBody.grouping
          settings: requestBody.settings
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/view/{view_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Retrieve a view's details (v2)
      effect: read
      questions:
      - What filters and grouping does a specific view use, per the v2 API?
      - Does the information returned about a view depend on its type?
      instructions:
      - text: Get the v2 details of view {view_id}.
        slots:
          view_id: path.view_id
      - text: Show the configuration of view {view_id} as the v2 API reports it.
        slots:
          view_id: path.view_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/view/{view_id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Reconfigure a view (v2)
      effect: write
      questions:
      - Can I rename a view and change its sorting at the same time with v2?
      - Which fields must be resent when updating a view through v2?
      instructions:
      - text: Using v2, rename view {view_id} to {name} and set its filters to {filters}.
        slots:
          view_id: path.view_id
          name: requestBody.name
          filters: requestBody.filters
      - text: Change v2 view {view_id} to type {type} under parent {parent} with columns {columns}.
        slots:
          view_id: path.view_id
          type: requestBody.type
          parent: requestBody.parent
          columns: requestBody.columns
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/view/{view_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a view (v2)
      effect: destructive
      questions:
      - How can I get rid of a view nobody uses anymore via the v2 API?
      - Does removing a view with v2 delete the tasks it shows?
      instructions:
      - text: Delete v2 view {view_id}.
        slots:
          view_id: path.view_id
      - text: Remove the unused view {view_id} using the v2 endpoint.
        slots:
          view_id: path.view_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/view/{view_id}/task'].get
  update:
    x-apievangelist-phrasing:
      intent: List tasks visible in a view (v2)
      effect: read
      questions:
      - Which tasks does a saved view currently show?
      - Is the v2 view tasks list paginated?
      instructions:
      - text: Get page {page} of the tasks visible in view {view_id} via v2.
        slots:
          page: query.page
          view_id: path.view_id
      - text: List the first page of tasks in v2 view {view_id}.
        slots:
          view_id: path.view_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/team/{team_id}/view'].get
  update:
    x-apievangelist-phrasing:
      intent: List Workspace-level views (legacy path)
      effect: read
      questions:
      - On the older unversioned path, what views span every Space in a Workspace?
      - Does the legacy API expose team-level views?
      instructions:
      - text: On the legacy path, fetch team-level views that span all Spaces in {team_id}.
        slots:
          team_id: path.team_id
      - text: Using the older endpoint, enumerate cross-Space views for Workspace {team_id}.
        slots:
          team_id: path.team_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/space/{space_id}/view'].get
  update:
    x-apievangelist-phrasing:
      intent: List a Space's views (legacy path)
      effect: read
      questions:
      - Does the legacy unversioned API return the views within a Space?
      - On the older endpoint, how are Space views retrieved?
      instructions:
      - text: On the legacy path, fetch views within Space {space_id}.
        slots:
          space_id: path.space_id
      - text: Using the older endpoint, enumerate Space {space_id} views.
        slots:
          space_id: path.space_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/folder/{folder_id}/view'].get
  update:
    x-apievangelist-phrasing:
      intent: List a Folder's views (legacy path)
      effect: read
      questions:
      - Does the older unversioned path list views inside a Folder?
      - On the legacy API, where do I find a Folder's saved views?
      instructions:
      - text: On the legacy path, fetch views within Folder {folder_id}.
        slots:
          folder_id: path.folder_id
      - text: Using the older endpoint, enumerate saved views in Folder {folder_id}.
        slots:
          folder_id: path.folder_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/list/{list_id}/view'].get
  update:
    x-apievangelist-phrasing:
      intent: List a List's views (legacy path)
      effect: read
      questions:
      - Can the older unversioned API tell me which views a List has?
      - On the legacy path, how do I read a List's saved views?
      instructions:
      - text: On the legacy path, fetch views within List {list_id}.
        slots:
          list_id: path.list_id
      - text: Using the older endpoint, enumerate saved views in List {list_id}.
        slots:
          list_id: path.list_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/view/{view_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Retrieve a view (legacy path)
      effect: read
      questions:
      - On the older unversioned path, how do I read one view's filters, sorting and columns?
      - Does the legacy view lookup include its grouping setup?
      instructions:
      - text: On the legacy path, read view {view_id} with its filters, sorting and columns.
        slots:
          view_id: path.view_id
      - text: Using the older endpoint, describe the setup of view {view_id}.
        slots:
          view_id: path.view_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/view/{view_id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Reconfigure a view (legacy path)
      effect: write
      questions:
      - Can the older unversioned endpoint change just a view's name without the other fields?
      - On the legacy path, can I adjust a view's grouping only?
      instructions:
      - text: On the legacy path, retitle view {view_id} as {name}.
        slots:
          view_id: path.view_id
          name: requestBody.name
      - text: Using the older endpoint, regroup view {view_id} by {grouping} and sort it by {sorting}.
        slots:
          view_id: path.view_id
          grouping: requestBody.grouping
          sorting: requestBody.sorting
      method: generated
      generated: '2026-09-26'
- target: $.paths['/view/{view_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a view (legacy path)
      effect: destructive
      questions:
      - Is removing a view through the older unversioned endpoint permanent?
      - Can a view erased on the legacy path be restored?
      instructions:
      - text: Permanently erase view {view_id} on the legacy path.
        slots:
          view_id: path.view_id
      - text: Using the older endpoint, wipe out view {view_id}.
        slots:
          view_id: path.view_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/view/{view_id}/task'].get
  update:
    x-apievangelist-phrasing:
      intent: List tasks in a view (legacy path)
      effect: read
      questions:
      - On the older unversioned path, does the view's filtering and sorting apply to the returned tasks?
      - Can the legacy API page through a view's tasks?
      instructions:
      - text: On the legacy path, fetch tasks shown by view {view_id} with its filters applied.
        slots:
          view_id: path.view_id
      - text: Using the older endpoint, get page {page} of view {view_id}'s tasks.
        slots:
          page: query.page
          view_id: path.view_id
      method: generated
      generated: '2026-09-26'