API Evangelist conversational phrasing for Access Management Service Identity API

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Access Management Service Identity API
  version: 1.0.0
extends: openapi/oracle-cloud-identity-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: 148
- target: $.paths['/allowedDomainLicenseTypes'].get
  update:
    x-apievangelist-phrasing:
      intent: List license types allowed for identity domains
      effect: read
      questions:
      - Which license types can I pick when creating an OCI identity domain?
      - What license types can my identity domain be moved to from its current license type?
      instructions:
      - text: Show the identity domain license types that are allowed.
      - text: List the domain license types I can switch to from {current_license}.
        slots:
          current_license: query.currentLicenseTypeName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/authenticationPolicies/{compartmentId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the tenancy's authentication policy
      effect: read
      questions:
      - What password rules and network restrictions apply to sign-ins in my tenancy?
      - Where can I see the current authentication policy for the whole tenancy?
      instructions:
      - text: Show the authentication policy for tenancy {tenancy}.
        slots:
          tenancy: path.compartmentId
      - text: Fetch the password policy settings currently enforced in tenancy {tenancy}.
        slots:
          tenancy: path.compartmentId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/authenticationPolicies/{compartmentId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update the tenancy's authentication policy
      effect: write
      questions:
      - Can I tighten the password requirements for local users in my tenancy?
      - How do I restrict console sign-ins to certain networks for the whole tenancy?
      instructions:
      - text: Change the password policy of tenancy {tenancy} to {password_policy}.
        slots:
          tenancy: path.compartmentId
          password_policy: requestBody.passwordPolicy
      - text: Apply network policy {network_policy} to the authentication policy of tenancy {tenancy}.
        slots:
          tenancy: path.compartmentId
          network_policy: requestBody.networkPolicy
      method: generated
      generated: '2026-09-26'
- target: $.paths['/availabilityDomains/'].get
  update:
    x-apievangelist-phrasing:
      intent: List availability domains in the tenancy
      effect: read
      questions:
      - Which availability domains does my tenancy have in this region?
      - What are the names of the availability domains I can launch resources into?
      instructions:
      - text: List the availability domains visible from compartment {compartment}.
        slots:
          compartment: query.compartmentId
      - text: Show me every availability domain in tenancy {tenancy}.
        slots:
          tenancy: query.compartmentId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/compartments/'].get
  update:
    x-apievangelist-phrasing:
      intent: List compartments inside a compartment
      effect: read
      questions:
      - What compartments sit under my root compartment?
      - Can I list every compartment in the whole subtree, not just direct children?
      - Which of my compartments are active versus deleted?
      instructions:
      - text: List the child compartments of {compartment}.
        slots:
          compartment: query.compartmentId
      - text: Find the compartment named {name} under {compartment}.
        slots:
          name: query.name
          compartment: query.compartmentId
      - text: List all compartments in the subtree of {compartment} that are {state}.
        slots:
          compartment: query.compartmentId
          state: query.lifecycleState
      method: generated
      generated: '2026-09-26'
- target: $.paths['/compartments/'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a compartment
      effect: write
      questions:
      - How do I create a new compartment to organize cloud resources?
      - Does a new compartment name have to be unique in my tenancy?
      instructions:
      - text: Create a compartment called {name} under {parent} described as {description}.
        slots:
          name: requestBody.name
          parent: requestBody.compartmentId
          description: requestBody.description
      - text: Set up a new child compartment {name} in parent compartment {parent}.
        slots:
          name: requestBody.name
          parent: requestBody.compartmentId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/compartments/bulkActionResourceTypes'].get
  update:
    x-apievangelist-phrasing:
      intent: List resource types supported by bulk actions
      effect: read
      questions:
      - Which resource types can I bulk move or bulk delete from a compartment?
      - What resource type names should I send in a compartment bulk action request?
      instructions:
      - text: List the resource types supported by the {action} bulk action.
        slots:
          action: query.bulkActionType
      - text: Show which resource types a bulk {action} on a compartment accepts.
        slots:
          action: query.bulkActionType
      method: generated
      generated: '2026-09-26'
- target: $.paths['/compartments/{compartmentId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a compartment's details
      effect: read
      questions:
      - What is the name, description and state of a particular compartment?
      - Can I check whether a specific compartment is still active?
      instructions:
      - text: Show the details of compartment {compartment}.
        slots:
          compartment: path.compartmentId
      - text: Get the lifecycle state of compartment {compartment}.
        slots:
          compartment: path.compartmentId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/compartments/{compartmentId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Rename or redescribe a compartment
      effect: write
      questions:
      - Can I rename an existing compartment?
      - Is it possible to change the description of the root compartment?
      instructions:
      - text: Rename compartment {compartment} to {name}.
        slots:
          compartment: path.compartmentId
          name: requestBody.name
      - text: Change the description of compartment {compartment} to {description}.
        slots:
          compartment: path.compartmentId
          description: requestBody.description
      method: generated
      generated: '2026-09-26'
- target: $.paths['/compartments/{compartmentId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an empty compartment
      effect: destructive
      questions:
      - How do I delete a compartment I no longer use?
      - Does a compartment have to be empty before it can be deleted?
      instructions:
      - text: Delete compartment {compartment}.
        slots:
          compartment: path.compartmentId
      - text: Remove the empty compartment {compartment} from my tenancy.
        slots:
          compartment: path.compartmentId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/compartments/{compartmentId}/actions/bulkDeleteResources'].post
  update:
    x-apievangelist-phrasing:
      intent: Delete many resources in a compartment at once
      effect: destructive
      questions:
      - Can I delete a batch of resources from one compartment in a single request?
      - What permissions do I need to bulk delete resources in a compartment?
      instructions:
      - text: Bulk delete resources {resources} from compartment {compartment}.
        slots:
          resources: requestBody.resources
          compartment: path.compartmentId
      - text: 'Clean out compartment {compartment} by deleting these resources together: {resources}.'
        slots:
          compartment: path.compartmentId
          resources: requestBody.resources
      method: generated
      generated: '2026-09-26'
- target: $.paths['/compartments/{compartmentId}/actions/bulkMoveResources'].post
  update:
    x-apievangelist-phrasing:
      intent: Move many resources to another compartment
      effect: write
      questions:
      - Can I move a group of resources to a different compartment all at once?
      - Do all the resources in a bulk move need to start in the same compartment?
      instructions:
      - text: Move resources {resources} from compartment {compartment} to {target}.
        slots:
          resources: requestBody.resources
          compartment: path.compartmentId
          target: requestBody.targetCompartmentId
      - text: 'Bulk relocate the listed resources in {compartment} into compartment {target}: {resources}.'
        slots:
          compartment: path.compartmentId
          target: requestBody.targetCompartmentId
          resources: requestBody.resources
      method: generated
      generated: '2026-09-26'
- target: $.paths['/compartments/{compartmentId}/actions/moveCompartment'].post
  update:
    x-apievangelist-phrasing:
      intent: Move a compartment under a new parent
      effect: write
      questions:
      - How do I move a whole compartment tree under a different parent compartment?
      - What happens to child compartments when I reparent a compartment?
      instructions:
      - text: Move compartment {compartment} under parent compartment {target}.
        slots:
          compartment: path.compartmentId
          target: requestBody.targetCompartmentId
      - text: Reparent compartment {compartment} and its subtree to {target}.
        slots:
          compartment: path.compartmentId
          target: requestBody.targetCompartmentId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/compartments/{compartmentId}/actions/recoverCompartment'].post
  update:
    x-apievangelist-phrasing:
      intent: Restore a deleted compartment
      effect: write
      questions:
      - Can I bring back a compartment I deleted by mistake?
      - Is there a way to return a DELETED compartment to ACTIVE?
      instructions:
      - text: Recover deleted compartment {compartment}.
        slots:
          compartment: path.compartmentId
      - text: Restore compartment {compartment} to the active state.
        slots:
          compartment: path.compartmentId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/domains/'].get
  update:
    x-apievangelist-phrasing:
      intent: List identity domains in the tenancy
      effect: read
      questions:
      - What identity domains exist in my tenancy?
      - Which identity domains use a particular license type?
      - Can I find identity domains that are hidden on the login page?
      instructions:
      - text: List the identity domains in compartment {compartment}.
        slots:
          compartment: query.compartmentId
      - text: Find identity domains in {compartment} named {display_name}.
        slots:
          compartment: query.compartmentId
          display_name: query.displayName
      - text: List identity domains in {compartment} with license type {license}.
        slots:
          compartment: query.compartmentId
          license: query.licenseType
      method: generated
      generated: '2026-09-26'
- target: $.paths['/domains/'].post
  update:
    x-apievangelist-phrasing:
      intent: Create an identity domain
      effect: write
      questions:
      - How do I create a new identity domain with its own admin user?
      - Which home region and license type do I have to choose for a new identity domain?
      instructions:
      - text: Create identity domain {display_name} in {compartment} with license {license} in home region {region}, described as {description}.
        slots:
          display_name: requestBody.displayName
          compartment: requestBody.compartmentId
          license: requestBody.licenseType
          region: requestBody.homeRegion
          description: requestBody.description
      - text: Set up a new identity domain {display_name} with admin email {admin_email}.
        slots:
          display_name: requestBody.displayName
          admin_email: requestBody.adminEmail
      method: generated
      generated: '2026-09-26'
- target: $.paths['/domains/{domainId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an identity domain's details
      effect: read
      questions:
      - What is the URL and home region of a specific identity domain?
      - Can I look up the current license type and state of one identity domain?
      instructions:
      - text: Show the details of identity domain {domain}.
        slots:
          domain: path.domainId
      - text: Get the home region URL of identity domain {domain}.
        slots:
          domain: path.domainId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/domains/{domainId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update an identity domain's settings
      effect: write
      questions:
      - Can I rename an identity domain or change its description?
      - How do I hide an identity domain from the sign-in page?
      instructions:
      - text: Rename identity domain {domain} to {display_name}.
        slots:
          domain: path.domainId
          display_name: requestBody.displayName
      - text: Set hidden-on-login to {hidden} for identity domain {domain}.
        slots:
          hidden: requestBody.isHiddenOnLogin
          domain: path.domainId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/domains/{domainId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an identity domain
      effect: destructive
      questions:
      - How do I permanently delete an identity domain?
      - Does an identity domain need to be deactivated before I can delete it?
      instructions:
      - text: Delete identity domain {domain}.
        slots:
          domain: path.domainId
      - text: Permanently remove the inactive identity domain {domain}.
        slots:
          domain: path.domainId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/domains/{domainId}/actions/activate'].post
  update:
    x-apievangelist-phrasing:
      intent: Reactivate a deactivated identity domain
      effect: write
      questions:
      - Can I turn a deactivated identity domain back on?
      - What does it take to reactivate an identity domain?
      instructions:
      - text: Activate identity domain {domain}.
        slots:
          domain: path.domainId
      - text: Bring deactivated identity domain {domain} back online.
        slots:
          domain: path.domainId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/domains/{domainId}/actions/changeCompartment'].post
  update:
    x-apievangelist-phrasing:
      intent: Move an identity domain to another compartment
      effect: write
      questions:
      - Can an identity domain be moved into a different compartment?
      - How do I relocate an identity domain within my tenancy?
      instructions:
      - text: Move identity domain {domain} to compartment {compartment}.
        slots:
          domain: path.domainId
          compartment: requestBody.compartmentId
      - text: Change the compartment of identity domain {domain} to {compartment}.
        slots:
          domain: path.domainId
          compartment: requestBody.compartmentId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/domains/{domainId}/actions/changeFaPodBaseUrl'].post
  update:
    x-apievangelist-phrasing:
      intent: Change an identity domain's Fusion Apps pod URL
      effect: write
      questions:
      - How do I update the FA pod base URL an identity domain points at?
      - Can I change which Fusion Applications pod an identity domain is linked to?
      instructions:
      - text: Set the FA pod base URL of identity domain {domain} to {url}.
        slots:
          domain: path.domainId
          url: requestBody.faPodBaseUrl
      - text: Point identity domain {domain} at Fusion Apps pod {url}.
        slots:
          domain: path.domainId
          url: requestBody.faPodBaseUrl
      method: generated
      generated: '2026-09-26'
- target: $.paths['/domains/{domainId}/actions/changeLicenseType'].post
  update:
    x-apievangelist-phrasing:
      intent: Change an identity domain's license type
      effect: write
      questions:
      - Can I upgrade an identity domain to a different license type?
      - How do I switch the license tier of an existing identity domain?
      instructions:
      - text: Change the license type of identity domain {domain} to {license}.
        slots:
          domain: path.domainId
          license: requestBody.licenseType
      - text: Upgrade identity domain {domain} to the {license} license.
        slots:
          domain: path.domainId
          license: requestBody.licenseType
      method: generated
      generated: '2026-09-26'
- target: $.paths['/domains/{domainId}/actions/deactivate'].post
  update:
    x-apievangelist-phrasing:
      intent: Deactivate an identity domain
      effect: destructive
      questions:
      - How do I deactivate an identity domain without deleting it?
      - Can I force deactivation of an identity domain?
      instructions:
      - text: Deactivate identity domain {domain}.
        slots:
          domain: path.domainId
      - text: Deactivate identity domain {domain} with force set to {force}.
        slots:
          domain: path.domainId
          force: query.isForceDeactivate
      method: generated
      generated: '2026-09-26'
- target: $.paths['/domains/{domainId}/actions/enableReplicationToRegion'].post
  update:
    x-apievangelist-phrasing:
      intent: Replicate an identity domain to a new region
      effect: write
      questions:
      - Can I replicate an identity domain into another region I subscribe to?
      - How do I make an identity domain available in an additional region?
      instructions:
      - text: Replicate identity domain {domain} to region {region}.
        slots:
          domain: path.domainId
          region: requestBody.replicaRegion
      - text: Enable replication of identity domain {domain} into {region}.
        slots:
          domain: path.domainId
          region: requestBody.replicaRegion
      method: generated
      generated: '2026-09-26'
- target: $.paths['/dynamicGroups/'].get
  update:
    x-apievangelist-phrasing:
      intent: List dynamic groups
      effect: read
      questions:
      - What dynamic groups are defined in my tenancy?
      - Is there a dynamic group with a specific name?
      instructions:
      - text: List the dynamic groups in tenancy {tenancy}.
        slots:
          tenancy: query.compartmentId
      - text: Find the dynamic group named {name} in tenancy {tenancy}.
        slots:
          name: query.name
          tenancy: query.compartmentId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/dynamicGroups/'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a dynamic group
      effect: write
      questions:
      - How do I group compute instances by a matching rule so they can call services?
      - What matching rule do I need to create a dynamic group?
      instructions:
      - text: Create dynamic group {name} in tenancy {tenancy} with matching rule {rule}, described as {description}.
        slots:
          name: requestBody.name
          tenancy: requestBody.compartmentId
          rule: requestBody.matchingRule
          description: requestBody.description
      - text: Make a new dynamic group {name} that matches {rule}.
        slots:
          name: requestBody.name
          rule: requestBody.matchingRule
      method: generated
      generated: '2026-09-26'
- target: $.paths['/dynamicGroups/{dynamicGroupId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a dynamic group's details
      effect: read
      questions:
      - What matching rule does a particular dynamic group use?
      - Can I view the details of one dynamic group?
      instructions:
      - text: Show dynamic group {dynamic_group}.
        slots:
          dynamic_group: path.dynamicGroupId
      - text: Get the matching rule of dynamic group {dynamic_group}.
        slots:
          dynamic_group: path.dynamicGroupId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/dynamicGroups/{dynamicGroupId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a dynamic group's matching rule
      effect: write
      questions:
      - Can I change which instances belong to an existing dynamic group?
      - How do I edit the description of a dynamic group?
      instructions:
      - text: Change the matching rule of dynamic group {dynamic_group} to {rule}.
        slots:
          dynamic_group: path.dynamicGroupId
          rule: requestBody.matchingRule
      - text: Update the description of dynamic group {dynamic_group} to {description}.
        slots:
          dynamic_group: path.dynamicGroupId
          description: requestBody.description
      method: generated
      generated: '2026-09-26'
- target: $.paths['/dynamicGroups/{dynamicGroupId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a dynamic group
      effect: destructive
      questions:
      - How do I remove a dynamic group I no longer need?
      - Can I delete a dynamic group that policies still reference?
      instructions:
      - text: Delete dynamic group {dynamic_group}.
        slots:
          dynamic_group: path.dynamicGroupId
      - text: Remove dynamic group {dynamic_group} from the tenancy.
        slots:
          dynamic_group: path.dynamicGroupId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/faultDomains/'].get
  update:
    x-apievangelist-phrasing:
      intent: List fault domains in an availability domain
      effect: read
      questions:
      - What fault domains are inside a given availability domain?
      - Which fault domains can I spread instances across for resilience?
      instructions:
      - text: List the fault domains in availability domain {ad} for compartment {compartment}.
        slots:
          ad: query.availabilityDomain
          compartment: query.compartmentId
      - text: Show fault domains of {ad}.
        slots:
          ad: query.availabilityDomain
      method: generated
      generated: '2026-09-26'
- target: $.paths['/groups/'].get
  update:
    x-apievangelist-phrasing:
      intent: List user groups
      effect: read
      questions:
      - What user groups exist in my tenancy?
      - Is there already a group with a given name?
      instructions:
      - text: List the groups in tenancy {tenancy}.
        slots:
          tenancy: query.compartmentId
      - text: Find the user group named {name} in tenancy {tenancy}.
        slots:
          name: query.name
          tenancy: query.compartmentId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/groups/'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a user group
      effect: write
      questions:
      - How do I create a group to grant a set of users the same permissions?
      - What fields are needed to create a new IAM group?
      instructions:
      - text: Create group {name} in tenancy {tenancy} described as {description}.
        slots:
          name: requestBody.name
          tenancy: requestBody.compartmentId
          description: requestBody.description
      - text: Add a new user group called {name}.
        slots:
          name: requestBody.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/groups/{groupId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a user group's details
      effect: read
      questions:
      - What is the description and state of a particular group?
      - Can I view one group's details by its OCID?
      instructions:
      - text: Show group {group}.
        slots:
          group: path.groupId
      - text: Get the details of user group {group}.
        slots:
          group: path.groupId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/groups/{groupId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a user group's description or tags
      effect: write
      questions:
      - Can I change a group's description after creating it?
      - How do I add free-form tags to an existing group?
      instructions:
      - text: Rewrite what IAM group {group} is for, using the text {description}.
        slots:
          group: path.groupId
          description: requestBody.description
      - text: Set free-form tags {tags} on group {group}.
        slots:
          tags: requestBody.freeformTags
          group: path.groupId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/groups/{groupId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an empty user group
      effect: destructive
      questions:
      - How do I delete a user group?
      - Must a group have no members before it can be deleted?
      instructions:
      - text: Delete group {group}.
        slots:
          group: path.groupId
      - text: Remove the empty user group {group}.
        slots:
          group: path.groupId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/iamWorkRequests'].get
  update:
    x-apievangelist-phrasing:
      intent: List IAM work requests
      effect: read
      questions:
      - What long-running IAM operations are in progress in my compartment?
      - Can I see the IAM work requests for a specific resource?
      instructions:
      - text: List IAM work requests in compartment {compartment}.
        slots:
          compartment: query.compartmentId
      - text: Show IAM work requests in {compartment} for resource {resource}.
        slots:
          compartment: query.compartmentId
          resource: query.resourceIdentifier
      method: generated
      generated: '2026-09-26'
- target: $.paths['/iamWorkRequests/{iamWorkRequestId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an IAM work request's status
      effect: read
      questions:
      - Has my IAM work request finished yet?
      - What is the progress of a specific IAM work request?
      instructions:
      - text: Show the status of IAM work request {work_request}.
        slots:
          work_request: path.iamWorkRequestId
      - text: Check how far IAM work request {work_request} has progressed.
        slots:
          work_request: path.iamWorkRequestId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/iamWorkRequests/{iamWorkRequestId}/errors'].get
  update:
    x-apievangelist-phrasing:
      intent: List errors from an IAM work request
      effect: read
      questions:
      - Why did my IAM work request fail?
      - Where do I find error details for an IAM work request?
      instructions:
      - text: List the errors for IAM work request {work_request}.
        slots:
          work_request: path.iamWorkRequestId
      - text: Show what went wrong in IAM work request {work_request}.
        slots:
          work_request: path.iamWorkRequestId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/iamWorkRequests/{iamWorkRequestId}/logs'].get
  update:
    x-apievangelist-phrasing:
      intent: List log entries of an IAM work request
      effect: read
      questions:
      - Can I read the log messages recorded for an IAM work request?
      - What steps has an IAM work request logged so far?
      instructions:
      - text: List the logs for IAM work request {work_request}.
        slots:
          work_request: path.iamWorkRequestId
      - text: Show the log trail of IAM work request {work_request}.
        slots:
          work_request: path.iamWorkRequestId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/identityProviders/'].get
  update:
    x-apievangelist-phrasing:
      intent: List federated identity providers (deprecated)
      effect: read
      questions:
      - Which SAML2 identity providers are federated with my tenancy?
      - Can I list the legacy federation identity providers by protocol?
      instructions:
      - text: List the {protocol} identity providers in tenancy {tenancy}.
        slots:
          protocol: query.protocol
          tenancy: query.compartmentId
      - text: Find the federated identity provider named {name} using protocol {protocol} in {tenancy}.
        slots:
          name: query.name
          protocol: query.protocol
          tenancy: query.compartmentId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/identityProviders/'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a federated identity provider (deprecated)
      effect: write
      questions:
      - How do I federate an external SAML2 identity provider with my tenancy using the legacy API?
      - What product type and protocol must I give a new federated identity provider?
      instructions:
      - text: Create identity provider {name} in {tenancy} for product {product_type} over {protocol}, described as {description}.
        slots:
          name: requestBody.name
          tenancy: requestBody.compartmentId
          product_type: requestBody.productType
          protocol: requestBody.protocol
          description: requestBody.description
      - text: Register a new {protocol} federation provider called {name}.
        slots:
          protocol: requestBody.protocol
          name: requestBody.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/identityProviders/{identityProviderId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a federated identity provider (deprecated)
      effect: read
      questions:
      - What are the settings of a specific federated identity provider?
      - Can I view one legacy identity provider's metadata by its OCID?
      instructions:
      - text: Show identity provider {idp}.
        slots:
          idp: path.identityProviderId
      - text: Get the details of federated identity provider {idp}.
        slots:
          idp: path.identityProviderId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/identityProviders/{identityProviderId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a federated identity provider (deprecated)
      effect: write
      questions:
      - Can I change the description of a federated identity provider?
      - How do I edit the settings of a legacy SAML2 identity provider?
      instructions:
      - text: Update identity provider {idp} over {protocol} with description {description}.
        slots:
          idp: path.identityProviderId
          protocol: requestBody.protocol
          description: requestBody.description
      - text: Edit federated identity provider {idp} using protocol {protocol}.
        slots:
          idp: path.identityProviderId
          protocol: requestBody.protocol
      method: generated
      generated: '2026-09-26'
- target: $.paths['/identityProviders/{identityProviderId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a federated identity provider (deprecated)
      effect: destructive
      questions:
      - How do I remove a federated identity provider from my tenancy?
      - Can I delete a legacy SAML2 federation I no longer use?
      instructions:
      - text: Delete identity provider {idp}.
        slots:
          idp: path.identityProviderId
      - text: Remove the federation with identity provider {idp}.
        slots:
          idp: path.identityProviderId
      method: generated
      generated: '2026-09-26'


# --- truncated at 32 KB (103 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/oracle-cloud/refs/heads/main/overlays/oracle-cloud-identity-api-phrasing-overlay.yaml