# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Prisma Projects API
  version: 1.0.0
extends: openapi/prisma-projects-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['/workspaces/{workspaceId}/projects'].get
  update:
    x-apievangelist-phrasing:
      intent: List projects in a workspace
      effect: read
      questions:
      - Which projects are in my workspace?
      - Can I list projects scoped to a single workspace?
      instructions:
      - text: List the projects in workspace {workspaceId}.
        slots:
          workspaceId: path.workspaceId
      - text: Show every project under {workspaceId}.
        slots:
          workspaceId: path.workspaceId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/workspaces/{workspaceId}/projects'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a project in a workspace
      effect: write
      questions:
      - How do I create a project inside a specific workspace?
      - What's required to add a project to a workspace?
      instructions:
      - text: Create a project named {name} in workspace {workspaceId}.
        slots:
          name: requestBody.name
          workspaceId: path.workspaceId
      - text: Add project {name} under {workspaceId}.
        slots:
          name: requestBody.name
          workspaceId: path.workspaceId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/projects/{projectId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a project with its environments
      effect: read
      questions:
      - Can I see a project's environments and database connections together?
      - Where do I get full details for one project?
      instructions:
      - text: Get project {projectId} with its environments.
        slots:
          projectId: path.projectId
      - text: Show the environments and database connections of project {projectId}.
        slots:
          projectId: path.projectId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/projects/{projectId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a project and its environments
      effect: destructive
      questions:
      - Does deleting a project remove all of its environments too?
      - Is there any way back after a project is deleted with its resources?
      instructions:
      - text: Permanently delete project {projectId} and all its environments.
        slots:
          projectId: path.projectId
      - text: Tear down {projectId} with every resource it holds.
        slots:
          projectId: path.projectId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/projects'].get
  update:
    x-apievangelist-phrasing:
      intent: List projects my token can access
      effect: read
      questions:
      - Which projects can my token reach across workspaces?
      - Can I look up a project by its logical ID?
      instructions:
      - text: List all my projects.
      - text: Find the project with logical ID {logicalId}.
        slots:
          logicalId: query.logicalId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/projects'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a project with a Postgres database
      effect: write
      questions:
      - How do I create a new project that comes with a Postgres database?
      - Can I choose the region when creating a project?
      instructions:
      - text: Create a project named {name} with a Postgres database.
        slots:
          name: requestBody.name
      - text: Create project {name} in region {region}.
        slots:
          name: requestBody.name
          region: requestBody.region
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/projects/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a project by ID (v1)
      effect: read
      questions:
      - What does the v1 API return for one project?
      - Can I fetch a single project by ID with the v1 endpoint?
      instructions:
      - text: Get project {id}.
        slots:
          id: path.id
      - text: Fetch project {id} from the v1 API.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/projects/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a project (v1)
      effect: destructive
      questions:
      - Can I delete a project by ID through the v1 API?
      - Is a project deleted through the v1 endpoint gone for good?
      instructions:
      - text: Delete project {id}.
        slots:
          id: path.id
      - text: Remove project {id} using the v1 endpoint.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/projects/{id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Rename a project or change its settings
      effect: write
      questions:
      - Can I rename an existing project?
      - What project settings can I change after creation?
      instructions:
      - text: Rename project {id} to {name}.
        slots:
          id: path.id
          name: requestBody.name
      - text: Update the settings of project {id} to {settings}.
        slots:
          id: path.id
          settings: requestBody.settings
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/projects/{id}/transfer'].post
  update:
    x-apievangelist-phrasing:
      intent: Transfer a project to another workspace
      effect: write
      questions:
      - How do I hand a project over to someone else's workspace?
      - What do I need from the recipient to transfer a project?
      instructions:
      - text: Transfer project {id} using recipient token {recipientAccessToken}.
        slots:
          id: path.id
          recipientAccessToken: requestBody.recipientAccessToken
      - text: Move project {id} to the workspace that owns {recipientAccessToken}.
        slots:
          id: path.id
          recipientAccessToken: requestBody.recipientAccessToken
      method: generated
      generated: '2026-09-26'