# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Edge Impulse Organization Blocks API
  version: 1.0.0
extends: openapi/edge-impulse-organizationblocks-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-10-01'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 30
- target: $.paths['/api/organizations/{organizationId}/transformation'].get
  update:
    x-apievangelist-phrasing:
      intent: List an organization's transformation blocks
      effect: read
      questions:
      - What transformation blocks has my Edge Impulse organization created?
      - Which of our own data transformation containers are registered?
      instructions:
      - text: List the transformation blocks in organization {organizationId}.
        slots:
          organizationId: path.organizationId
      - text: Show our own transformation blocks for organization {organizationId}.
        slots:
          organizationId: path.organizationId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/organizations/{organizationId}/transformation'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a transformation block
      effect: write
      questions:
      - How do I register a Docker container as a data transformation block?
      - Can I set CPU and memory limits when adding a new transformation block?
      instructions:
      - text: Add a transformation block {name} to organization {organizationId} using container {dockerContainer}.
        slots:
          name: requestBody.name
          organizationId: path.organizationId
          dockerContainer: requestBody.dockerContainer
      - text: Register new transformation block {name} in organization {organizationId} that operates on {operatesOn}.
        slots:
          name: requestBody.name
          organizationId: path.organizationId
          operatesOn: requestBody.operatesOn
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/organizations/{organizationId}/transformation/public'].get
  update:
    x-apievangelist-phrasing:
      intent: List public transformation blocks
      effect: read
      questions:
      - Which transformation blocks have other organizations published for everyone to use?
      - Are there ready-made public transformation blocks I can reuse?
      instructions:
      - text: List public transformation blocks available to organization {organizationId}.
        slots:
          organizationId: path.organizationId
      - text: Show transformation blocks published by other organizations, as seen from {organizationId}.
        slots:
          organizationId: path.organizationId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/organizations/{organizationId}/transformation/public/{transformationId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a public transformation block
      effect: read
      questions:
      - What does a specific public transformation block from another organization do?
      - Can I view the details of one shared transformation block before using it?
      instructions:
      - text: Get public transformation block {transformationId} for organization {organizationId}.
        slots:
          transformationId: path.transformationId
          organizationId: path.organizationId
      - text: Show details of the publicly shared transformation block {transformationId} from organization {organizationId}.
        slots:
          transformationId: path.transformationId
          organizationId: path.organizationId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/organizations/{organizationId}/transformation/{transformationId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one of our transformation blocks
      effect: read
      questions:
      - What container and CLI arguments does one of our transformation blocks use?
      - How do I look up a single transformation block my organization owns?
      instructions:
      - text: Get our transformation block {transformationId} in organization {organizationId}.
        slots:
          transformationId: path.transformationId
          organizationId: path.organizationId
      - text: Show the settings of organization {organizationId} transformation block {transformationId}.
        slots:
          transformationId: path.transformationId
          organizationId: path.organizationId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/organizations/{organizationId}/transformation/{transformationId}'].post
  update:
    x-apievangelist-phrasing:
      intent: Update a transformation block
      effect: write
      questions:
      - How do I change the Docker image of an existing transformation block?
      - Can I make one of our transformation blocks public or show it in data sources?
      instructions:
      - text: Update transformation block {transformationId} in organization {organizationId} to use container {dockerContainer}.
        slots:
          transformationId: path.transformationId
          organizationId: path.organizationId
          dockerContainer: requestBody.dockerContainer
      - text: Set public visibility of transformation block {transformationId} in organization {organizationId} to {isPublic}.
        slots:
          transformationId: path.transformationId
          organizationId: path.organizationId
          isPublic: requestBody.isPublic
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/organizations/{organizationId}/transformation/{transformationId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a transformation block
      effect: destructive
      questions:
      - How do I remove a transformation block my organization no longer uses?
      - Can I delete a custom data transformation block?
      instructions:
      - text: Delete transformation block {transformationId} from organization {organizationId}.
        slots:
          transformationId: path.transformationId
          organizationId: path.organizationId
      - text: Remove our transformation block {transformationId} in organization {organizationId}.
        slots:
          transformationId: path.transformationId
          organizationId: path.organizationId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/organizations/{organizationId}/transformation/{transformationId}/export'].post
  update:
    x-apievangelist-phrasing:
      intent: Download a transformation block's source
      effect: read
      questions:
      - Can I download the source code behind a transformation block?
      - How do I export a transformation block to edit it locally?
      instructions:
      - text: Export the source code of transformation block {transformationId} in organization {organizationId}.
        slots:
          transformationId: path.transformationId
          organizationId: path.organizationId
      - text: Download transformation block {transformationId} code from organization {organizationId}.
        slots:
          transformationId: path.transformationId
          organizationId: path.organizationId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/organizations/{organizationId}/deploy'].get
  update:
    x-apievangelist-phrasing:
      intent: List an organization's deploy blocks
      effect: read
      questions:
      - What custom deployment targets has my organization defined?
      - Which deploy blocks are available to package our models?
      instructions:
      - text: List the deploy blocks in organization {organizationId}.
        slots:
          organizationId: path.organizationId
      - text: Show all custom deployment blocks for organization {organizationId}.
        slots:
          organizationId: path.organizationId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/organizations/{organizationId}/deploy'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a deploy block
      effect: write
      questions:
      - How do I add a custom deployment target built from my own container?
      - Can a new deploy block support the EON Compiler or run privileged?
      instructions:
      - text: Add deploy block {name} to organization {organizationId} using container {dockerContainer}.
        slots:
          name: requestBody.name
          organizationId: path.organizationId
          dockerContainer: requestBody.dockerContainer
      - text: Create a deploy block {name} in organization {organizationId} under category {category}.
        slots:
          name: requestBody.name
          organizationId: path.organizationId
          category: requestBody.category
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/organizations/{organizationId}/deploy/{deployId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a deploy block
      effect: read
      questions:
      - Which container and resource limits does a particular deploy block use?
      - How can I view one deploy block's configuration?
      instructions:
      - text: Get deploy block {deployId} in organization {organizationId}.
        slots:
          deployId: path.deployId
          organizationId: path.organizationId
      - text: Show the configuration of deployment block {deployId} for organization {organizationId}.
        slots:
          deployId: path.deployId
          organizationId: path.organizationId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/organizations/{organizationId}/deploy/{deployId}'].post
  update:
    x-apievangelist-phrasing:
      intent: Update a deploy block
      effect: write
      questions:
      - How do I change the container image of an existing deploy block?
      - Can I turn on EON Compiler support for a deploy block I already added?
      instructions:
      - text: Update deploy block {deployId} in organization {organizationId} to use container {dockerContainer}.
        slots:
          deployId: path.deployId
          organizationId: path.organizationId
          dockerContainer: requestBody.dockerContainer
      - text: Set EON Compiler support on deploy block {deployId} in organization {organizationId} to {supportsEonCompiler}.
        slots:
          deployId: path.deployId
          organizationId: path.organizationId
          supportsEonCompiler: requestBody.supportsEonCompiler
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/organizations/{organizationId}/deploy/{deployId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a deploy block
      effect: destructive
      questions:
      - How do I remove a custom deployment target from my organization?
      - Can I delete a deploy block that is no longer needed?
      instructions:
      - text: Delete deploy block {deployId} from organization {organizationId}.
        slots:
          deployId: path.deployId
          organizationId: path.organizationId
      - text: Remove deployment block {deployId} in organization {organizationId}.
        slots:
          deployId: path.deployId
          organizationId: path.organizationId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/organizations/{organizationId}/deploy/{deployId}/export'].post
  update:
    x-apievangelist-phrasing:
      intent: Download a deploy block's source
      effect: read
      questions:
      - Can I download the source code of a deploy block?
      - How do I export a custom deployment block's code?
      instructions:
      - text: Export the source code of deploy block {deployId} in organization {organizationId}.
        slots:
          deployId: path.deployId
          organizationId: path.organizationId
      - text: Download deployment block {deployId} code from organization {organizationId}.
        slots:
          deployId: path.deployId
          organizationId: path.organizationId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/organizations/{organizationId}/dsp'].get
  update:
    x-apievangelist-phrasing:
      intent: List an organization's DSP blocks
      effect: read
      questions:
      - Which custom signal processing blocks does my organization have?
      - What DSP blocks have we hosted for feature extraction?
      instructions:
      - text: List the DSP blocks in organization {organizationId}.
        slots:
          organizationId: path.organizationId
      - text: Show all custom signal processing blocks for organization {organizationId}.
        slots:
          organizationId: path.organizationId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/organizations/{organizationId}/dsp'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a DSP block
      effect: write
      questions:
      - How do I host my own signal processing container as a DSP block?
      - Which port does a new DSP block need to listen on?
      instructions:
      - text: Add DSP block {name} to organization {organizationId} from container {dockerContainer} on port {port}.
        slots:
          name: requestBody.name
          organizationId: path.organizationId
          dockerContainer: requestBody.dockerContainer
          port: requestBody.port
      - text: Create a custom DSP block {name} in organization {organizationId} described as {description}.
        slots:
          name: requestBody.name
          organizationId: path.organizationId
          description: requestBody.description
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/organizations/{organizationId}/dsp/{dspId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a DSP block
      effect: read
      questions:
      - What container and port is a particular DSP block running on?
      - How can I check one DSP block's settings?
      instructions:
      - text: Get DSP block {dspId} in organization {organizationId}.
        slots:
          dspId: path.dspId
          organizationId: path.organizationId
      - text: Show the configuration of signal processing block {dspId} for organization {organizationId}.
        slots:
          dspId: path.dspId
          organizationId: path.organizationId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/organizations/{organizationId}/dsp/{dspId}'].post
  update:
    x-apievangelist-phrasing:
      intent: Update a DSP block
      effect: write
      questions:
      - How do I change the port or container image of an existing DSP block?
      - Can I adjust memory limits on a DSP block I already added?
      instructions:
      - text: Update DSP block {dspId} in organization {organizationId} to use container {dockerContainer}.
        slots:
          dspId: path.dspId
          organizationId: path.organizationId
          dockerContainer: requestBody.dockerContainer
      - text: Change the port of DSP block {dspId} in organization {organizationId} to {port}.
        slots:
          dspId: path.dspId
          organizationId: path.organizationId
          port: requestBody.port
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/organizations/{organizationId}/dsp/{dspId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a DSP block
      effect: destructive
      questions:
      - How do I remove a custom DSP block from my organization?
      - Can I delete a signal processing block we no longer use?
      instructions:
      - text: Delete DSP block {dspId} from organization {organizationId}.
        slots:
          dspId: path.dspId
          organizationId: path.organizationId
      - text: Remove signal processing block {dspId} in organization {organizationId}.
        slots:
          dspId: path.dspId
          organizationId: path.organizationId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/organizations/{organizationId}/dsp/{dspId}/export'].post
  update:
    x-apievangelist-phrasing:
      intent: Download a DSP block's source
      effect: read
      questions:
      - Can I download the source code of a DSP block?
      - How do I export a custom signal processing block's code?
      instructions:
      - text: Export the source code of DSP block {dspId} in organization {organizationId}.
        slots:
          dspId: path.dspId
          organizationId: path.organizationId
      - text: Download signal processing block {dspId} code from organization {organizationId}.
        slots:
          dspId: path.dspId
          organizationId: path.organizationId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/organizations/{organizationId}/dsp/{dspId}/retry'].post
  update:
    x-apievangelist-phrasing:
      intent: Retry launching a DSP block
      effect: write
      questions:
      - What can I do when a DSP block failed to start or lost its connection?
      - Is there a way to relaunch a DSP block that isn't responding?
      instructions:
      - text: Retry the connection to DSP block {dspId} in organization {organizationId}.
        slots:
          dspId: path.dspId
          organizationId: path.organizationId
      - text: Relaunch signal processing block {dspId} for organization {organizationId}.
        slots:
          dspId: path.dspId
          organizationId: path.organizationId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/organizations/{organizationId}/transfer-learning'].get
  update:
    x-apievangelist-phrasing:
      intent: List an organization's transfer learning blocks
      effect: read
      questions:
      - Which custom transfer learning blocks has my organization added?
      - What of our own learning models are available as training blocks?
      instructions:
      - text: List the transfer learning blocks in organization {organizationId}.
        slots:
          organizationId: path.organizationId
      - text: Show all custom training (transfer learning) blocks for organization {organizationId}.
        slots:
          organizationId: path.organizationId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/organizations/{organizationId}/transfer-learning'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a transfer learning block
      effect: write
      questions:
      - How do I bring my own model architecture as a transfer learning block?
      - Can a new transfer learning block be flagged as requiring a GPU?
      instructions:
      - text: Add transfer learning block {name} to organization {organizationId} from container {dockerContainer}.
        slots:
          name: requestBody.name
          organizationId: path.organizationId
          dockerContainer: requestBody.dockerContainer
      - text: Register a new transfer learning block {name} in organization {organizationId} that operates on {operatesOn}.
        slots:
          name: requestBody.name
          organizationId: path.organizationId
          operatesOn: requestBody.operatesOn
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/organizations/{organizationId}/transfer-learning/{transferLearningId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a transfer learning block
      effect: read
      questions:
      - What container and parameters does a particular transfer learning block use?
      - How can I look up one transfer learning block by ID?
      instructions:
      - text: Get transfer learning block {transferLearningId} in organization {organizationId}.
        slots:
          transferLearningId: path.transferLearningId
          organizationId: path.organizationId
      - text: Show the settings of training block {transferLearningId} for organization {organizationId}.
        slots:
          transferLearningId: path.transferLearningId
          organizationId: path.organizationId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/organizations/{organizationId}/transfer-learning/{transferLearningId}'].post
  update:
    x-apievangelist-phrasing:
      intent: Update a transfer learning block
      effect: write
      questions:
      - How do I change the container image of an existing transfer learning block?
      - Can I make one of our transfer learning blocks public for devices?
      instructions:
      - text: Update transfer learning block {transferLearningId} in organization {organizationId} to use container {dockerContainer}.
        slots:
          transferLearningId: path.transferLearningId
          organizationId: path.organizationId
          dockerContainer: requestBody.dockerContainer
      - text: Set GPU requirement on training block {transferLearningId} in organization {organizationId} to {indRequiresGpu}.
        slots:
          transferLearningId: path.transferLearningId
          organizationId: path.organizationId
          indRequiresGpu: requestBody.indRequiresGpu
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/organizations/{organizationId}/transfer-learning/{transferLearningId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a transfer learning block
      effect: destructive
      questions:
      - How do I remove a custom transfer learning block from my organization?
      - Can I delete a training block we no longer use?
      instructions:
      - text: Delete transfer learning block {transferLearningId} from organization {organizationId}.
        slots:
          transferLearningId: path.transferLearningId
          organizationId: path.organizationId
      - text: Remove training block {transferLearningId} in organization {organizationId}.
        slots:
          transferLearningId: path.transferLearningId
          organizationId: path.organizationId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/organizations/{organizationId}/transfer-learning/{transferLearningId}/export'].post
  update:
    x-apievangelist-phrasing:
      intent: Download a transfer learning block's source
      effect: read
      questions:
      - Can I download the source code of a transfer learning block?
      - How do I export a custom training block's code?
      instructions:
      - text: Export the source code of transfer learning block {transferLearningId} in organization {organizationId}.
        slots:
          transferLearningId: path.transferLearningId
          organizationId: path.organizationId
      - text: Download training block {transferLearningId} code from organization {organizationId}.
        slots:
          transferLearningId: path.transferLearningId
          organizationId: path.organizationId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/organizations/{organizationId}/secrets'].get
  update:
    x-apievangelist-phrasing:
      intent: List an organization's secrets
      effect: read
      questions:
      - Which secrets are stored for my organization's custom blocks?
      - Can I see the names of all secrets we've saved?
      instructions:
      - text: List the secrets in organization {organizationId}.
        slots:
          organizationId: path.organizationId
      - text: Show all stored secrets for organization {organizationId}.
        slots:
          organizationId: path.organizationId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/organizations/{organizationId}/secrets'].post
  update:
    x-apievangelist-phrasing:
      intent: Add an organization secret
      effect: write
      questions:
      - How do I store a credential securely for my organization's blocks to use?
      - Can I add a described secret value to my organization?
      instructions:
      - text: Add secret {name} with value {secret} to organization {organizationId}.
        slots:
          name: requestBody.name
          secret: requestBody.secret
          organizationId: path.organizationId
      - text: Store a new secret {name} in organization {organizationId}, described as {description}.
        slots:
          name: requestBody.name
          organizationId: path.organizationId
          description: requestBody.description
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/organizations/{organizationId}/secrets/{secretId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an organization secret
      effect: destructive
      questions:
      - How do I remove a stored secret from my organization?
      - Can I delete a credential that's been compromised?
      instructions:
      - text: Delete secret {secretId} from organization {organizationId}.
        slots:
          secretId: path.secretId
          organizationId: path.organizationId
      - text: Remove stored secret {secretId} in organization {organizationId}.
        slots:
          secretId: path.secretId
          organizationId: path.organizationId
      method: generated
      generated: '2026-10-01'