# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Functions Service Functions Management API
  version: 1.0.0
extends: openapi/oracle-cloud-functionsmanagement-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: 16
- target: $.paths['/applications'].get
  update:
    x-apievangelist-phrasing:
      intent: List function applications in a compartment
      effect: read
      questions:
      - Which Functions applications exist in my compartment?
      - Can I filter applications by display name or lifecycle state?
      instructions:
      - text: List the Functions applications in compartment {compartmentId}.
        slots:
          compartmentId: query.compartmentId
      - text: Find the application named {displayName} in compartment {compartmentId}.
        slots:
          displayName: query.displayName
          compartmentId: query.compartmentId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/applications'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a Functions application
      effect: write
      questions:
      - How do I create an application to hold my Oracle Cloud Functions?
      - Which subnets and shape does a new Functions application need?
      instructions:
      - text: Create a Functions application {displayName} in compartment {compartmentId} on subnets {subnetIds}.
        slots:
          displayName: requestBody.displayName
          compartmentId: requestBody.compartmentId
          subnetIds: requestBody.subnetIds
      - text: Create application {displayName} in {compartmentId} using subnets {subnetIds} with shape {shape}.
        slots:
          displayName: requestBody.displayName
          compartmentId: requestBody.compartmentId
          subnetIds: requestBody.subnetIds
          shape: requestBody.shape
      method: generated
      generated: '2026-09-26'
- target: $.paths['/applications/{applicationId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the details of a Functions application
      effect: read
      questions:
      - What configuration and subnets does a particular Functions application use?
      - Is my Functions application active?
      instructions:
      - text: Show Functions application {applicationId}.
        slots:
          applicationId: path.applicationId
      - text: Get the config and network settings of application {applicationId}.
        slots:
          applicationId: path.applicationId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/applications/{applicationId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a Functions application's configuration
      effect: write
      questions:
      - Can I change the shared config variables on an existing Functions application?
      - How do I turn on tracing or change the syslog URL for an application?
      instructions:
      - text: Set the config of application {applicationId} to {config}.
        slots:
          applicationId: path.applicationId
          config: requestBody.config
      - text: Point the syslog URL of Functions application {applicationId} at {syslogUrl}.
        slots:
          applicationId: path.applicationId
          syslogUrl: requestBody.syslogUrl
      method: generated
      generated: '2026-09-26'
- target: $.paths['/applications/{applicationId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a Functions application
      effect: destructive
      questions:
      - How do I remove a Functions application I no longer need?
      - Can a Functions application be deleted by its OCID?
      instructions:
      - text: Delete Functions application {applicationId}.
        slots:
          applicationId: path.applicationId
      - text: Remove the application {applicationId} from Oracle Functions.
        slots:
          applicationId: path.applicationId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/applications/{applicationId}/actions/changeCompartment'].post
  update:
    x-apievangelist-phrasing:
      intent: Move a Functions application to another compartment
      effect: write
      questions:
      - Can I move a Functions application to a different compartment in my tenancy?
      - What happens to an application's functions when I change its compartment?
      instructions:
      - text: Move Functions application {applicationId} to compartment {compartmentId}.
        slots:
          applicationId: path.applicationId
          compartmentId: requestBody.compartmentId
      - text: Relocate application {applicationId} into compartment {compartmentId}.
        slots:
          applicationId: path.applicationId
          compartmentId: requestBody.compartmentId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/functions'].get
  update:
    x-apievangelist-phrasing:
      intent: List the functions in an application
      effect: read
      questions:
      - Which functions are deployed inside one application?
      - Can I sort or filter an application's functions by name?
      instructions:
      - text: List the functions in application {applicationId}.
        slots:
          applicationId: query.applicationId
      - text: Find function {displayName} in application {applicationId}.
        slots:
          displayName: query.displayName
          applicationId: query.applicationId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/functions'].post
  update:
    x-apievangelist-phrasing:
      intent: Deploy a new function in an application
      effect: write
      questions:
      - How do I deploy a new serverless function from a container image?
      - What memory and timeout limits can I set on a new function?
      instructions:
      - text: Create function {displayName} in application {applicationId} from image {image} with {memoryInMBs} MB memory.
        slots:
          displayName: requestBody.displayName
          applicationId: requestBody.applicationId
          image: requestBody.image
          memoryInMBs: requestBody.memoryInMBs
      - text: Deploy function {displayName} to {applicationId} with {memoryInMBs} MB and a {timeoutInSeconds}-second timeout.
        slots:
          displayName: requestBody.displayName
          applicationId: requestBody.applicationId
          memoryInMBs: requestBody.memoryInMBs
          timeoutInSeconds: requestBody.timeoutInSeconds
      method: generated
      generated: '2026-09-26'
- target: $.paths['/functions/{functionId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the details of a function
      effect: read
      questions:
      - What image, memory and timeout is a particular function running with?
      - Where do I find a function's invoke endpoint?
      instructions:
      - text: Show function {functionId}.
        slots:
          functionId: path.functionId
      - text: Get the image and memory settings of function {functionId}.
        slots:
          functionId: path.functionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/functions/{functionId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update an existing function
      effect: write
      questions:
      - How do I point an existing function at a new image version?
      - Can I increase the memory of a function that's already deployed?
      instructions:
      - text: Update function {functionId} to use image {image}.
        slots:
          functionId: path.functionId
          image: requestBody.image
      - text: Change the memory of existing function {functionId} to {memoryInMBs} MB.
        slots:
          functionId: path.functionId
          memoryInMBs: requestBody.memoryInMBs
      method: generated
      generated: '2026-09-26'
- target: $.paths['/functions/{functionId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a function
      effect: destructive
      questions:
      - How do I delete a function I've deployed?
      - Can I remove a single function without deleting its application?
      instructions:
      - text: Delete function {functionId}.
        slots:
          functionId: path.functionId
      - text: Remove the deployed function {functionId} from its application.
        slots:
          functionId: path.functionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/pbfListingVersions'].get
  update:
    x-apievangelist-phrasing:
      intent: List the versions of a pre-built function listing
      effect: read
      questions:
      - What versions are available for a given pre-built function?
      - Which version of a pre-built function is the current one?
      instructions:
      - text: List the versions of pre-built function listing {pbfListingId}.
        slots:
          pbfListingId: query.pbfListingId
      - text: Show only the current version of pre-built function {pbfListingId}, with current-version set to {isCurrentVersion}.
        slots:
          pbfListingId: query.pbfListingId
          isCurrentVersion: query.isCurrentVersion
      method: generated
      generated: '2026-09-26'
- target: $.paths['/pbfListingVersions/{pbfListingVersionId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one version of a pre-built function listing
      effect: read
      questions:
      - What does a specific pre-built function version require to deploy?
      - Can I look up a single PBF listing version by its ID?
      instructions:
      - text: Show pre-built function listing version {pbfListingVersionId}.
        slots:
          pbfListingVersionId: path.pbfListingVersionId
      - text: Get the details of PBF version {pbfListingVersionId}.
        slots:
          pbfListingVersionId: path.pbfListingVersionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/pbfListings'].get
  update:
    x-apievangelist-phrasing:
      intent: Browse the catalog of pre-built functions
      effect: read
      questions:
      - What pre-built functions does Oracle offer that I can deploy?
      - Can I search pre-built functions by name or by trigger type?
      instructions:
      - text: List all available pre-built function listings.
      - text: Find pre-built functions whose name contains {nameContains}.
        slots:
          nameContains: query.nameContains
      - text: Show pre-built functions that use trigger {trigger}.
        slots:
          trigger: query.trigger
      method: generated
      generated: '2026-09-26'
- target: $.paths['/pbfListings/triggers'].get
  update:
    x-apievangelist-phrasing:
      intent: List the triggers available for pre-built functions
      effect: read
      questions:
      - What kinds of triggers can start a pre-built function?
      - Is there a list of all trigger names for the pre-built function catalog?
      instructions:
      - text: List every trigger type for pre-built functions.
      - text: Look up the pre-built function trigger named {name}.
        slots:
          name: query.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/pbfListings/{pbfListingId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one pre-built function listing
      effect: read
      questions:
      - What does a particular pre-built function do and who publishes it?
      - Can I fetch a single pre-built function listing by its ID?
      instructions:
      - text: Show pre-built function listing {pbfListingId}.
        slots:
          pbfListingId: path.pbfListingId
      - text: Get the description and triggers of PBF listing {pbfListingId}.
        slots:
          pbfListingId: path.pbfListingId
      method: generated
      generated: '2026-09-26'