API Evangelist conversational phrasing for Clickup Spaces 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 Spaces API
  version: 1.0.0
extends: openapi/clickup-spaces-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: 10
- target: $.paths['/v2/team/{team_id}/space'].get
  update:
    x-apievangelist-phrasing:
      intent: List the Spaces in a Workspace (v2)
      effect: read
      questions:
      - What Spaces are in my Workspace, via the v2 endpoint?
      - Can I include archived Spaces in the v2 Spaces listing?
      instructions:
      - text: Via v2, list Spaces in Workspace {team_id}.
        slots:
          team_id: path.team_id
      - text: Using v2, list Spaces in Workspace {team_id} with archived set to {archived}.
        slots:
          team_id: path.team_id
          archived: query.archived
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/team/{team_id}/space'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a Space (v2)
      effect: write
      questions:
      - How do I add a new Space to a Workspace through v2?
      - Which settings are required when creating a Space with v2?
      instructions:
      - text: Via v2, create Space {name} in Workspace {team_id} with multiple assignees {multiple_assignees} and features {features}.
        slots:
          name: requestBody.name
          team_id: path.team_id
          multiple_assignees: requestBody.multiple_assignees
          features: requestBody.features
      - text: Using v2, add a Space named {name} to Workspace {team_id}.
        slots:
          name: requestBody.name
          team_id: path.team_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/space/{space_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Space's details (v2)
      effect: read
      questions:
      - How do I look up a single Space via v2?
      - Can I fetch one Space by its ID with the v2 endpoint?
      instructions:
      - text: Via v2, get Space {space_id}.
        slots:
          space_id: path.space_id
      - text: Using v2, show the details of Space {space_id}.
        slots:
          space_id: path.space_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/space/{space_id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a Space's settings (v2)
      effect: write
      questions:
      - How do I rename a Space or set its color via v2?
      - Can I turn ClickApps on for a Space with the v2 update?
      instructions:
      - text: Via v2, make Space {space_id} private {private} and set its enabled ClickApps to {features}.
        slots:
          space_id: path.space_id
          private: requestBody.private
          features: requestBody.features
      - text: Using v2, rename Space {space_id} to {name}.
        slots:
          space_id: path.space_id
          name: requestBody.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/space/{space_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a Space (v2)
      effect: destructive
      questions:
      - What's the v2 endpoint for removing a Space from my Workspace?
      - Can I delete a Space by ID via v2?
      instructions:
      - text: Via v2, delete Space {space_id}.
        slots:
          space_id: path.space_id
      - text: Using v2, remove Space {space_id} from the Workspace.
        slots:
          space_id: path.space_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/team/{team_id}/space'].get
  update:
    x-apievangelist-phrasing:
      intent: List Spaces (unversioned path)
      effect: read
      questions:
      - Which non-v2 endpoint lists all Spaces in a Workspace?
      - Can I get archived Spaces from the unversioned path?
      instructions:
      - text: Using the unversioned path, list Spaces in Workspace {team_id}.
        slots:
          team_id: path.team_id
      - text: On the non-v2 endpoint, show Spaces in Workspace {team_id} including archived ones.
        slots:
          team_id: path.team_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/team/{team_id}/space'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a Space (unversioned path)
      effect: write
      questions:
      - Is there a non-v2 path to create a Space with just a name?
      - Can I configure a new Space's features on the unversioned endpoint?
      instructions:
      - text: Using the unversioned path, create Space {name} in Workspace {team_id}.
        slots:
          name: requestBody.name
          team_id: path.team_id
      - text: On the non-v2 endpoint, create Space {name} in Workspace {team_id} with features {features}.
        slots:
          name: requestBody.name
          team_id: path.team_id
          features: requestBody.features
      method: generated
      generated: '2026-09-26'
- target: $.paths['/space/{space_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Space's features and statuses (unversioned)
      effect: read
      questions:
      - Which non-v2 endpoint returns a Space's features and statuses?
      - Can I read a Space's configuration on the unversioned path?
      instructions:
      - text: Using the unversioned path, get Space {space_id}.
        slots:
          space_id: path.space_id
      - text: On the non-v2 endpoint, show the statuses and features of Space {space_id}.
        slots:
          space_id: path.space_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/space/{space_id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a Space (unversioned path)
      effect: write
      questions:
      - Is there a non-v2 path to make a Space private?
      - Can I change just a Space's color on the unversioned endpoint?
      instructions:
      - text: Using the unversioned path, set Space {space_id} private to {private}.
        slots:
          space_id: path.space_id
          private: requestBody.private
      - text: On the non-v2 endpoint, change Space {space_id} color to {color}.
        slots:
          space_id: path.space_id
          color: requestBody.color
      method: generated
      generated: '2026-09-26'
- target: $.paths['/space/{space_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a Space and all contents (unversioned)
      effect: destructive
      questions:
      - Does deleting a Space on the non-v2 path also remove its Folders, Lists and tasks?
      - Is Space deletion through the unversioned endpoint reversible?
      instructions:
      - text: Using the unversioned path, permanently delete Space {space_id} and everything in it.
        slots:
          space_id: path.space_id
      - text: On the non-v2 endpoint, remove Space {space_id} with its Folders, Lists and tasks.
        slots:
          space_id: path.space_id
      method: generated
      generated: '2026-09-26'