API Evangelist conversational phrasing for Prisma Postgres Management [Experimental] API

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Prisma Postgres Management [Experimental] API
  version: 1.0.0
extends: openapi/prisma-experimental-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: 70
- target: $.paths['/v1/apps'].get
  update:
    x-apievangelist-phrasing:
      intent: List apps (deprecated, use services)
      effect: read
      questions:
      - Which legacy apps does my token have access to?
      - Can I still list apps by project now that apps are deprecated?
      instructions:
      - text: List my deprecated apps.
      - text: List the legacy apps in project {projectId}.
        slots:
          projectId: query.projectId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/apps'].post
  update:
    x-apievangelist-phrasing:
      intent: Create an app (deprecated, use services)
      effect: write
      questions:
      - Is creating an app still supported now that apps are deprecated?
      - What do I need to create a legacy app in a project?
      instructions:
      - text: Create a legacy app called {displayName} in project {projectId}.
        slots:
          displayName: requestBody.displayName
          projectId: requestBody.projectId
      - text: Set up deprecated app {displayName} for {projectId} in region {regionId}.
        slots:
          displayName: requestBody.displayName
          projectId: requestBody.projectId
          regionId: requestBody.regionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/apps/{appId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an app (deprecated)
      effect: read
      questions:
      - Can I still look up a legacy app and its promoted deployment?
      - Which region is my old app running in?
      instructions:
      - text: Get legacy app {appId}.
        slots:
          appId: path.appId
      - text: Show region and live deployment of deprecated app {appId}.
        slots:
          appId: path.appId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/apps/{appId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an app (deprecated)
      effect: destructive
      questions:
      - Are an app's deployments removed when I delete the legacy app?
      - Can I still delete an app through the deprecated apps endpoint?
      instructions:
      - text: Delete legacy app {appId}.
        slots:
          appId: path.appId
      - text: Remove deprecated app {appId} and its deployments.
        slots:
          appId: path.appId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/apps/{appId}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Rename an app (deprecated)
      effect: write
      questions:
      - Can I rename a legacy app?
      - Is it possible to move an old app onto another git branch?
      instructions:
      - text: Rename legacy app {appId} to {displayName}.
        slots:
          appId: path.appId
          displayName: requestBody.displayName
      - text: Attach deprecated app {appId} to git branch {branchGitName}.
        slots:
          appId: path.appId
          branchGitName: requestBody.branchGitName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/apps/{appId}/promote'].post
  update:
    x-apievangelist-phrasing:
      intent: Promote a deployment on an app (deprecated)
      effect: write
      questions:
      - Can I still make a running deployment live on a legacy app?
      - Does promoting on the old app endpoint require the deployment to be running?
      instructions:
      - text: Promote deployment {deploymentId} on legacy app {appId}.
        slots:
          deploymentId: requestBody.deploymentId
          appId: path.appId
      - text: Make {deploymentId} the active deployment behind deprecated app {appId}.
        slots:
          deploymentId: requestBody.deploymentId
          appId: path.appId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/apps/{appId}/rollback'].post
  update:
    x-apievangelist-phrasing:
      intent: Roll an app back to a deployment (deprecated)
      effect: write
      questions:
      - Can I roll a legacy app back to an earlier deployment without downtime?
      - Will rolling back an old app start a stopped deployment first?
      instructions:
      - text: Roll legacy app {appId} back to deployment {deploymentId}.
        slots:
          appId: path.appId
          deploymentId: requestBody.deploymentId
      - text: Put {deploymentId} live again on deprecated app {appId}.
        slots:
          deploymentId: requestBody.deploymentId
          appId: path.appId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/apps/{appId}/domains'].get
  update:
    x-apievangelist-phrasing:
      intent: List an app's custom domains (deprecated)
      effect: read
      questions:
      - Which custom domains are attached to my legacy app?
      - Can I see domains across all deployments of an old app?
      instructions:
      - text: List custom domains on legacy app {appId}.
        slots:
          appId: path.appId
      - text: Show the hostnames bound to deprecated app {appId}.
        slots:
          appId: path.appId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/apps/{appId}/domains'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a custom domain to an app (deprecated)
      effect: write
      questions:
      - Can I still register a custom hostname on a legacy app?
      - What DNS setup does a custom domain on an old app need?
      instructions:
      - text: Add custom domain {hostname} to legacy app {appId}.
        slots:
          hostname: requestBody.hostname
          appId: path.appId
      - text: Register {hostname} for deprecated app {appId}.
        slots:
          hostname: requestBody.hostname
          appId: path.appId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/apps/{appId}/deployments'].get
  update:
    x-apievangelist-phrasing:
      intent: List an app's deployments (deprecated)
      effect: read
      questions:
      - Which deployments does my legacy app have?
      - Are an old app's deployments listed newest first?
      instructions:
      - text: List deployments of legacy app {appId}.
        slots:
          appId: path.appId
      - text: Show {limit} recent deployments for deprecated app {appId}.
        slots:
          limit: query.limit
          appId: path.appId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/apps/{appId}/deployments'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a deployment for an app (deprecated)
      effect: write
      questions:
      - Can I still create a deployment under a legacy app?
      - Can a new deployment on an old app reuse the current artifact instead of uploading code?
      instructions:
      - text: Create a deployment for legacy app {appId}.
        slots:
          appId: path.appId
      - text: Deploy deprecated app {appId} again with skipCodeUpload {skipCodeUpload}.
        slots:
          appId: path.appId
          skipCodeUpload: requestBody.skipCodeUpload
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/services'].get
  update:
    x-apievangelist-phrasing:
      intent: List compute services
      effect: read
      questions:
      - Which compute services can my token access?
      - Can I list the services in one project or git branch?
      instructions:
      - text: List my compute services.
      - text: List services in project {projectId}.
        slots:
          projectId: query.projectId
      - text: Show services on git branch {branchGitName}.
        slots:
          branchGitName: query.branchGitName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/services'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a compute service
      effect: write
      questions:
      - How do I create a compute service in a project?
      - Can I choose the region a new service runs in?
      instructions:
      - text: Create a service called {displayName} in project {projectId}.
        slots:
          displayName: requestBody.displayName
          projectId: requestBody.projectId
      - text: Set up service {displayName} for {projectId} in region {regionId}.
        slots:
          displayName: requestBody.displayName
          projectId: requestBody.projectId
          regionId: requestBody.regionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/services/{serviceId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a compute service
      effect: read
      questions:
      - Which deployment is currently promoted on my service?
      - What region is a given compute service in?
      instructions:
      - text: Get service {serviceId}.
        slots:
          serviceId: path.serviceId
      - text: Show region and live deployment of service {serviceId}.
        slots:
          serviceId: path.serviceId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/services/{serviceId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a compute service
      effect: destructive
      questions:
      - Does deleting a service also delete its deployments?
      - How do I tear down a compute service completely?
      instructions:
      - text: Delete service {serviceId}.
        slots:
          serviceId: path.serviceId
      - text: Remove service {serviceId} along with all its deployments.
        slots:
          serviceId: path.serviceId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/services/{serviceId}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Rename a compute service
      effect: write
      questions:
      - Can I rename a compute service?
      - Is it possible to move a service onto a different git branch?
      instructions:
      - text: Rename service {serviceId} to {displayName}.
        slots:
          serviceId: path.serviceId
          displayName: requestBody.displayName
      - text: Attach service {serviceId} to git branch {branchGitName}.
        slots:
          serviceId: path.serviceId
          branchGitName: requestBody.branchGitName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/services/{serviceId}/promote'].post
  update:
    x-apievangelist-phrasing:
      intent: Promote a running deployment on a service
      effect: write
      questions:
      - How do I make a running deployment live behind my service's stable endpoint?
      - Does a deployment have to be running before I promote it?
      instructions:
      - text: Promote deployment {deploymentId} on service {serviceId}.
        slots:
          deploymentId: requestBody.deploymentId
          serviceId: path.serviceId
      - text: Make {deploymentId} the active deployment behind service {serviceId}.
        slots:
          deploymentId: requestBody.deploymentId
          serviceId: path.serviceId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/services/{serviceId}/rollback'].post
  update:
    x-apievangelist-phrasing:
      intent: Roll a service back to an earlier deployment
      effect: write
      questions:
      - Can I roll my service back to an earlier deployment with zero downtime?
      - Will a rollback start a stopped deployment before switching traffic?
      instructions:
      - text: Roll service {serviceId} back to deployment {deploymentId}.
        slots:
          serviceId: path.serviceId
          deploymentId: requestBody.deploymentId
      - text: Put {deploymentId} live again on service {serviceId}.
        slots:
          deploymentId: requestBody.deploymentId
          serviceId: path.serviceId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/services/{serviceId}/domains'].get
  update:
    x-apievangelist-phrasing:
      intent: List a service's custom domains
      effect: read
      questions:
      - Which custom domains are attached to my service?
      - Are domains shown across every deployment of a service?
      instructions:
      - text: List custom domains on service {serviceId}.
        slots:
          serviceId: path.serviceId
      - text: Show the hostnames bound to service {serviceId}.
        slots:
          serviceId: path.serviceId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/services/{serviceId}/domains'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a custom domain to a service
      effect: write
      questions:
      - How do I put my own hostname in front of a service?
      - What CNAME does a custom domain for a service need?
      instructions:
      - text: Add custom domain {hostname} to service {serviceId}.
        slots:
          hostname: requestBody.hostname
          serviceId: path.serviceId
      - text: Register {hostname} for service {serviceId}.
        slots:
          hostname: requestBody.hostname
          serviceId: path.serviceId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/services/{serviceId}/deployments'].get
  update:
    x-apievangelist-phrasing:
      intent: List a service's deployments
      effect: read
      questions:
      - Which deployments does my service have?
      - Are a service's deployments listed newest first?
      instructions:
      - text: List deployments of service {serviceId}.
        slots:
          serviceId: path.serviceId
      - text: Show {limit} recent deployments for service {serviceId}.
        slots:
          limit: query.limit
          serviceId: path.serviceId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/services/{serviceId}/deployments'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a deployment for a service
      effect: write
      questions:
      - How do I create a new deployment and get an upload URL for my code?
      - Can a new deployment reuse the currently promoted artifact instead of uploading code?
      instructions:
      - text: Create a deployment for service {serviceId}.
        slots:
          serviceId: path.serviceId
      - text: Redeploy service {serviceId} with skipCodeUpload {skipCodeUpload}.
        slots:
          serviceId: path.serviceId
          skipCodeUpload: requestBody.skipCodeUpload
      - text: Deploy service {serviceId} with port mapping {portMapping}.
        slots:
          serviceId: path.serviceId
          portMapping: requestBody.portMapping
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/projects/{projectId}/branches'].get
  update:
    x-apievangelist-phrasing:
      intent: List a project's branches
      effect: read
      questions:
      - Which live branches does my project have?
      - Can I find a branch by its exact git name?
      - Is there a way to search branches by part of their git name?
      instructions:
      - text: List the branches in project {projectId}.
        slots:
          projectId: path.projectId
      - text: Find the branch named {gitName} in {projectId}.
        slots:
          gitName: query.gitName
          projectId: path.projectId
      - text: Show branches in {projectId} whose git name contains {gitNameContains}.
        slots:
          projectId: path.projectId
          gitNameContains: query.gitNameContains
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/projects/{projectId}/branches'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a branch in a project
      effect: write
      questions:
      - How do I add a preview branch to a project?
      - What happens when the first branch is created in a project?
      instructions:
      - text: Create branch {gitName} in project {projectId}.
        slots:
          gitName: requestBody.gitName
          projectId: path.projectId
      - text: Add branch {gitName} to {projectId} as the default with isDefault {isDefault}.
        slots:
          gitName: requestBody.gitName
          projectId: path.projectId
          isDefault: requestBody.isDefault
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/branches/{branchId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a branch
      effect: read
      questions:
      - What are the details of one branch?
      - Can I check whether a branch is the project default?
      instructions:
      - text: Get branch {branchId}.
        slots:
          branchId: path.branchId
      - text: Show me the git name and role of branch {branchId}.
        slots:
          branchId: path.branchId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/branches/{branchId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Soft-delete a branch
      effect: destructive
      questions:
      - Why would deleting a branch be refused?
      - Can I delete a branch that still has databases or services on it?
      instructions:
      - text: Delete branch {branchId}.
        slots:
          branchId: path.branchId
      - text: Soft-delete preview branch {branchId}.
        slots:
          branchId: path.branchId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/branches/{branchId}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Make a branch the project default
      effect: write
      questions:
      - How do I change which branch is my project's default?
      - Can I rename a branch's git name after it is created?
      instructions:
      - text: Make branch {branchId} the project default.
        slots:
          branchId: path.branchId
      - text: Set isDefault to {isDefault} on branch {branchId}.
        slots:
          isDefault: requestBody.isDefault
          branchId: path.branchId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/builds'].get
  update:
    x-apievangelist-phrasing:
      intent: List builds in my workspace
      effect: read
      questions:
      - Which builds ran recently in my workspace?
      - Can I see only the failed builds for one project?
      instructions:
      - text: List my recent builds.
      - text: Show builds in project {projectId} with state {state}.
        slots:
          projectId: query.projectId
          state: query.state
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/builds'].post
  update:
    x-apievangelist-phrasing:
      intent: Report a build from CI or the CLI
      effect: write
      questions:
      - How do I record a CI build so it shows up in the platform?
      - Can reporting the same CI run twice create a duplicate build?
      instructions:
      - text: Report a {source} build of commit {commitSha} on branch {branchName}.
        slots:
          source: requestBody.source
          commitSha: requestBody.commitSha
          branchName: requestBody.branchName
      - text: Record build run {runIdentity} for {commitSha} on {branchName} from {source}.
        slots:
          runIdentity: requestBody.runIdentity
          commitSha: requestBody.commitSha
          branchName: requestBody.branchName
          source: requestBody.source
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/builds/{buildId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a build and the resources it touched
      effect: read
      questions:
      - What resources did a particular build act on?
      - Where can I see the state of one build?
      instructions:
      - text: Get build {buildId}.
        slots:
          buildId: path.buildId
      - text: Show the resources build {buildId} reported acting on.
        slots:
          buildId: path.buildId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/builds/{buildId}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Report progress on a build
      effect: write
      questions:
      - How do I mark a build as failed and record the failing step?
      - Can I add the deployed URL to a build after it finishes?
      instructions:
      - text: Set build {buildId} to state {state}.
        slots:
          buildId: path.buildId
          state: requestBody.state
      - text: Mark build {buildId} failed at step {failingStep} with error {errorMessage}.
        slots:
          buildId: path.buildId
          failingStep: requestBody.failingStep
          errorMessage: requestBody.errorMessage
      - text: Record that build {buildId} deployed to {deployedUrl}.
        slots:
          buildId: path.buildId
          deployedUrl: requestBody.deployedUrl
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/builds/{buildId}/resources/{resourceType}/{resourceId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Record a resource a build acted on
      effect: write
      questions:
      - How do I record that a build created or deleted a database?
      - Can re-reporting a resource weaken the action already recorded on a build?
      instructions:
      - text: Record that build {buildId} {action} {resourceType} {resourceId}.
        slots:
          buildId: path.buildId
          action: requestBody.action
          resourceType: path.resourceType
          resourceId: path.resourceId
      - text: 'Log provenance: build {buildId} acted on {resourceType} {resourceId} with action {action}.'
        slots:
          buildId: path.buildId
          resourceType: path.resourceType
          resourceId: path.resourceId
          action: requestBody.action
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/builds/{buildId}/logs'].get
  update:
    x-apievangelist-phrasing:
      intent: Stream a build's logs
      effect: read
      questions:
      - How do I tail the logs of a build that is still running?
      - Can I resume reading build logs from where I stopped?
      instructions:
      - text: Show the build log for {buildId}.
        slots:
          buildId: path.buildId
      - text: Follow build {buildId}'s log live with follow set to {follow}.
        slots:
          buildId: path.buildId
          follow: query.follow
      - text: Resume build {buildId}'s log from cursor {cursor}.
        slots:
          buildId: path.buildId
          cursor: query.cursor
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/domains/{domainId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a custom domain
      effect: read
      questions:
      - What is the verification and certificate status of my custom domain?
      - Where do I look up one custom domain by its ID?
      instructions:
      - text: Get custom domain {domainId}.
        slots:
          domainId: path.domainId
      - text: Check the provisioning status of domain {domainId}.
        slots:
          domainId: path.domainId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/domains/{domainId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a custom domain
      effect: destructive
      questions:
      - How do I unbind a custom domain from my service?
      - Can I remove a hostname I no longer own?
      instructions:
      - text: Delete custom domain {domainId}.
        slots:
          domainId: path.domainId
      - text: Unbind hostname {domainId} from its service.
        slots:
          domainId: path.domainId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/domains/{domainId}/retry'].post
  update:
    x-apievangelist-phrasing:
      intent: Retry custom domain provisioning
      effect: write
      questions:
      - My custom domain failed verification; can I retry the DNS check?
      - Is there a way to reissue the certificate for a pending domain?
      instructions:
      - text: Retry provisioning for domain {domainId}.
        slots:
          domainId: path.domainId
      - text: Re-run DNS verification and certificate issuance for {domainId}.
        slots:
          domainId: path.domainId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/deployments/{deploymentId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a deployment's status
      effect: read
      questions:
      - Is my deployment running yet?
      - What status does a given deployment have right now?
      instructions:
      - text: Get deployment {deploymentId}.
        slots:
          deploymentId: path.deploymentId
      - text: Check whether deployment {deploymentId} is running.
        slots:
          deploymentId: path.deploymentId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/deployments/{deploymentId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a stopped deployment
      effect: destructive
      questions:
      - Do I need to stop a deployment before deleting it?
      - Does deleting a deployment remove its VM too?
      instructions:
      - text: Delete deployment {deploymentId}.
        slots:
          deploymentId: path.deploymentId
      - text: Permanently remove {deploymentId} and its VM.
        slots:
          deploymentId: path.deploymentId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/deployments/{deploymentId}/start'].post
  update:
    x-apievangelist-phrasing:
      intent: Start a deployment's VM
      effect: write
      questions:
      - How do I boot a deployment after uploading its artifact?
      - Where do I get the preview domain for a newly started deployment?
      instructions:
      - text: Start deployment {deploymentId}.
        slots:
          deploymentId: path.deploymentId
      - text: Boot the VM for {deploymentId} and give me its preview domain.
        slots:
          deploymentId: path.deploymentId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/deployments/{deploymentId}/stop'].post
  update:
    x-apievangelist-phrasing:
      intent: Stop a deployment's VM
      effect: write
      questions:
      - Can I shut down a deployment but keep its record?
      - What should I poll to confirm a deployment has stopped?
      instructions:
      - text: Stop deployment {deploymentId}.
        slots:
          deploymentId: path.deploymentId
      - text: Shut down the VM behind {deploymentId}.
        slots:
          deploymentId: path.deploymentId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/deployments/{deploymentId}/logs'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a deployment's runtime logs
      effect: read
      questions:
      - How do I see the last lines my deployment logged?
      - Can I read a deployment's logs from the very beginning?
      instructions:
      - text: Show logs for deployment {deploymentId}.
        slots:
          deploymentId: path.deploymentId
      - text: Get the last {tail} log lines of {deploymentId}.
        slots:
          tail: query.tail
          deploymentId: path.deploymentId
      - text: Read {deploymentId}'s logs from the start with from_start {from_start}.
        slots:
          deploymentId: path.deploymentId
          from_start: query.from_start
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/projects/{projectId}/branches/{branchId}/alchemy-state/lease'].post
  update:
    x-apievangelist-phrasing:
      intent: Acquire an Alchemy deploy lease
      effect: write
      questions:
      - How do I take the Alchemy deploy lease for a stack and stage?
      - What happens if another deploy already holds the lease?
      instructions:
      - text: Acquire the deploy lease for stack {stack} stage {stage} on branch {branchId} of {projectId}.
        slots:
          projectId: path.projectId
          branchId: path.branchId
          stack: requestBody.stack
          stage: requestBody.stage
      - text: Take the lease on {stack}/{stage} in {projectId} branch {branchId} for {ttlSeconds} seconds.
        slots:
          projectId: path.projectId
          branchId: path.branchId
          stack: requestBody.stack
          stage: requestBody.stage
          ttlSeconds: requestBody.ttlSeconds
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/projects/{projectId}/branches/{branchId}/alchemy-state/lease'].delete
  update:
    x-apievangelist-phrasing:
      intent: Release an Alchemy deploy lease
      effect: destructive
      questions:
      - How do I give up the Alchemy lease when a deploy exits cleanly?
      - What does it mean if releasing my lease returns not found?
      instructions:
      - text: Release lease {lease} on branch {branchId} of project {projectId}.
        slots:
          projectId: path.projectId
          branchId: path.branchId
          lease: header.alchemy-state-lease-id
      - text: Drop deploy lease {lease} for {projectId} branch {branchId}.
        slots:
          projectId: path.projectId
          branchId: path.branchId
          lease: header.alchemy-state-lease-id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/projects/{projectId}/branches/{branchId}/alchemy-state/lease'].patch
  update:
    x-apievangelist-phrasing:
      intent: Extend an Alchemy deploy lease
      effect: write
      questions:
      - How do I keep my Alchemy deploy lease alive during a long deploy?
      - Can an expired lease be revived with a heartbeat?
      instructions:
      - text: Heartbeat lease {lease} on branch {branchId} of {projectId}.
        slots:
          projectId: path.projectId
          branchId: path.branchId
          lease: header.alchemy-state-lease-id
      - text: Extend lease {lease} for {projectId} branch {branchId} by {ttlSeconds} seconds.
        slots:
          projectId: path.projectId
          branchId: path.branchId
          ttlSeconds: requestBody.ttlSeconds
          lease: header.alchemy-state-lease-id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/projects/{projectId}/branches/{branchId}/alchemy-state/version'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the Alchemy state store version
      effect: read
      questions:
      - Which Alchemy state store contract version does the platform serve?
      - Does checking the state store version need authentication?
      instructions:
      - text: Get the Alchemy state store version for branch {branchId} of {projectId}.
        slots:
          projectId: path.projectId
          branchId: path.branchId
      - text: Probe the state API contract version on {projectId} branch {branchId}.
        slots:
          projectId: path.projectId
          branchId: path.branchId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/projects/{projectId}/branches/{branchId}/alchemy-state/state/stacks'].get
  update:
    x-apievangelist-phrasing:
      intent: List Alchemy stacks on a branch
      effect: read
      questions:
      - Which Alchemy stacks have stored state on my branch?
      - Can I list stack names without holding a deploy lease?
      instructions:
      - text: List the Alchemy stacks on branch {branchId} of {projectId}.
        slots:
          projectId: path.projectId
          branchId: path.branchId
      - text: Show stack names with state in {projectId} branch {branchId}.
        slots:
          projectId: path.projectId
          branchId: path.branchId
      method: generated
      generated: '2026-09-26'


# --- truncated at 32 KB (51 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/prisma/refs/heads/main/overlays/prisma-experimental-api-phrasing-overlay.yaml