API Evangelist conversational phrasing for Tray Ai Projects API

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Tray Ai Projects API
  version: 1.0.0
extends: openapi/tray-ai-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: 11
- target: $.paths['/               '].post
  update:
    x-apievangelist-phrasing:
      intent: Import a project via the embedded root endpoint
      effect: write
      questions:
      - Can I import a project by posting to the embedded root endpoint with a master token?
      - Which embedded root call loads a previously exported project into my account?
      instructions:
      - text: Post an import-project request to the embedded root with variables {variables}.
        slots:
          variables: requestBody.variables
      - text: Import a project through the embedded root endpoint using my master token.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/                '].post
  update:
    x-apievangelist-phrasing:
      intent: Export a project via the embedded root endpoint
      effect: read
      questions:
      - Is there an embedded root call that exports a whole project with a master token?
      - How can I pull a project export out through the embedded root endpoint?
      instructions:
      - text: Post an export-project request to the embedded root for project {variables}.
        slots:
          variables: requestBody.variables
      - text: Export the project through the embedded root endpoint with my master token.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/                 '].post
  update:
    x-apievangelist-phrasing:
      intent: Export a project's config via the embedded root
      effect: read
      questions:
      - Can I export only a project's configuration, not the whole project?
      - Which embedded root call returns the config of a project?
      instructions:
      - text: Export the config for project {variables} through the embedded root endpoint.
        slots:
          variables: requestBody.variables
      - text: Pull just the project configuration using my master token.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/projects/{projectId}/export'].post
  update:
    x-apievangelist-phrasing:
      intent: Export a project for environment promotion
      effect: read
      questions:
      - How do I move a project from my staging workspace to production?
      - Can I export a project version by project id to promote it between environments?
      instructions:
      - text: Export project {project} so I can promote it to production.
        slots:
          project: path.projectId
      - text: Create a promotion export of project {project} from staging.
        slots:
          project: path.projectId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/projects/import'].post
  update:
    x-apievangelist-phrasing:
      intent: Import exported project data into a workspace
      effect: write
      questions:
      - Can I import exported project data into a different target workspace?
      - What do I pass to bring a promoted project into production via /projects/import?
      instructions:
      - text: Import exported project data {data} into workspace {workspace}.
        slots:
          data: requestBody.exportedData
          workspace: requestBody.workspaceId
      - text: Promote the export {data} into my target workspace.
        slots:
          data: requestBody.exportedData
      method: generated
      generated: '2026-09-26'
- target: $.paths['/core/v1/projects/{projectId}/versions/{versionNumber}'].post
  update:
    x-apievangelist-phrasing:
      intent: Save a project version
      effect: write
      questions:
      - How do I snapshot a project's current state so I can release or roll back to it later?
      - Can I give a saved project version a title and description?
      instructions:
      - text: Save project {project} as version {version} titled {title}.
        slots:
          project: path.projectId
          version: path.versionNumber
          title: requestBody.title
      - text: Create version {version} of project {project} called {title} with notes {description}.
        slots:
          version: path.versionNumber
          project: path.projectId
          title: requestBody.title
          description: requestBody.description
      method: generated
      generated: '2026-09-26'
- target: $.paths['/core/v1/projects/{projectId}/versions'].get
  update:
    x-apievangelist-phrasing:
      intent: List a project's saved versions
      effect: read
      questions:
      - Which saved versions exist for my project?
      - Can I page through a project's version history?
      instructions:
      - text: List the saved versions of project {project}.
        slots:
          project: path.projectId
      - text: Show the first {count} versions of project {project}.
        slots:
          count: query.first
          project: path.projectId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/core/v1/projects/{projectId}/versions/{versionNumber}/export'].get
  update:
    x-apievangelist-phrasing:
      intent: Export a specific project version as JSON
      effect: read
      questions:
      - Can I download the JSON for one particular saved version of a project?
      - What does a saved project version look like when exported?
      instructions:
      - text: Export version {version} of project {project} as JSON.
        slots:
          version: path.versionNumber
          project: path.projectId
      - text: Get the JSON of project {project} at saved version {version}.
        slots:
          project: path.projectId
          version: path.versionNumber
      method: generated
      generated: '2026-09-26'
- target: $.paths['/core/v1/projects/{projectId}/imports/requirements'].post
  update:
    x-apievangelist-phrasing:
      intent: Get the requirements to import a project
      effect: read
      questions:
      - Which authentications and config mappings will an import need before I run it?
      - What do I have to resolve before importing an exported project?
      instructions:
      - text: Check what authentications and config project {project} needs to import {export}.
        slots:
          project: path.projectId
          export: requestBody.exportedProjectJson
      - text: List import requirements for {export} into project {project} with connector mapping {connectors} and service mapping {services}.
        slots:
          export: requestBody.exportedProjectJson
          project: path.projectId
          connectors: requestBody.connectorMapping
          services: requestBody.serviceMapping
      method: generated
      generated: '2026-09-26'
- target: $.paths['/core/v1/projects/{projectId}/imports/previews'].post
  update:
    x-apievangelist-phrasing:
      intent: Preview the impact of a project import
      effect: read
      questions:
      - What would change in my project and solution if I applied this import?
      - Can I dry-run a project import before committing it?
      instructions:
      - text: Preview importing {export} into project {project} with auth resolution {auths}.
        slots:
          export: requestBody.exportedProjectJson
          project: path.projectId
          auths: requestBody.authenticationResolution
      - text: Dry-run import of {export} into {project} using connector mapping {connectors} and service mapping {services}.
        slots:
          export: requestBody.exportedProjectJson
          project: path.projectId
          connectors: requestBody.connectorMapping
          services: requestBody.serviceMapping
      method: generated
      generated: '2026-09-26'
- target: $.paths['/core/v1/projects/{projectId}/imports'].post
  update:
    x-apievangelist-phrasing:
      intent: Import a project with dependency mappings
      effect: write
      questions:
      - How do I apply an import to a project with my own config and authentication mappings?
      - Can I override config values when importing into an existing project?
      instructions:
      - text: Import {export} into project {project}, resolving authentications with {auths}.
        slots:
          export: requestBody.exportedProjectJson
          project: path.projectId
          auths: requestBody.authenticationResolution
      - text: Apply the import of {export} to {project} with config override {config}.
        slots:
          export: requestBody.exportedProjectJson
          project: path.projectId
          config: requestBody.configOverride
      method: generated
      generated: '2026-09-26'