# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Microsoft Azure Features API
  version: 1.0.0
extends: openapi/microsoft-azure-features-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: 17
- target: $.paths['/features/datasets/{datasetId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the landing page of an indoor map dataset
      effect: read
      questions:
      - Where do I start when exploring the Features service for my Creator indoor map dataset?
      - What links does the dataset landing page give me to the API definition and conformance?
      instructions:
      - text: Open the Features landing page for my indoor map dataset with API version {api_version}.
        slots:
          api_version: query.api-version
      - text: Get the entry-point links for Creator dataset {datasetId}'s feature service.
        slots:
          datasetId: path.datasetId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/features/datasets/{datasetId}/api'].get
  update:
    x-apievangelist-phrasing:
      intent: Describe the Features service capabilities
      effect: read
      questions:
      - What request types and parameters does each Azure Maps Features API support?
      - Can I get a machine-readable description of what the Features service can do?
      instructions:
      - text: Fetch the Features service API definition with API version {api_version}.
        slots:
          api_version: query.api-version
      - text: Describe the capabilities of every API in the Features service for dataset {datasetId}.
        slots:
          datasetId: path.datasetId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/features/datasets/{datasetId}/conformance'].get
  update:
    x-apievangelist-phrasing:
      intent: List OGC conformance classes supported
      effect: read
      questions:
      - Which OGC API Features conformance classes does the Creator features server conform to?
      - Does the indoor map Features service declare OGC conformance?
      instructions:
      - text: List the OGC conformance classes the Features server supports under API version {api_version}.
        slots:
          api_version: query.api-version
      - text: Show the conformance statements for dataset {datasetId}'s feature service.
        slots:
          datasetId: path.datasetId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/features/datasets/{datasetId}/collections'].get
  update:
    x-apievangelist-phrasing:
      intent: List feature collections in a dataset
      effect: read
      questions:
      - What feature collections, like units or levels, are in my indoor map dataset?
      - Can I see every collection my Creator dataset exposes?
      instructions:
      - text: List all feature collections in my indoor map dataset using API version {api_version}.
        slots:
          api_version: query.api-version
      - text: Show which collections Creator dataset {datasetId} contains.
        slots:
          datasetId: path.datasetId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/features/datasets/{datasetId}/collections/{collectionId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get details of a feature collection
      effect: read
      questions:
      - What does the metadata of a single feature collection in my dataset look like?
      - Can I get the links and description for just one collection?
      instructions:
      - text: Show the details of feature collection {collection_id}.
        slots:
          collection_id: path.collectionId
      - text: Describe the {collection_id} collection in indoor map dataset {datasetId}.
        slots:
          collection_id: path.collectionId
          datasetId: path.datasetId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/features/datasets/{datasetId}/collections/{collectionId}/definition'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the data model of a feature collection
      effect: read
      questions:
      - Which attributes and types does a feature collection's data model define?
      - What schema must features in a given collection follow?
      instructions:
      - text: Get the detailed data model for collection {collection_id}.
        slots:
          collection_id: path.collectionId
      - text: Show the attribute definition of features in {collection_id} of dataset {datasetId}.
        slots:
          collection_id: path.collectionId
          datasetId: path.datasetId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/features/datasets/{datasetId}/collections/{collectionId}/items'].get
  update:
    x-apievangelist-phrasing:
      intent: List features in a collection
      effect: read
      questions:
      - How can I pull the features inside a map area using a bounding box?
      - Can I filter the features in a collection and cap how many come back?
      instructions:
      - text: List up to {limit} features from collection {collection_id} in dataset {datasetId}.
        slots:
          limit: query.limit
          collection_id: path.collectionId
          datasetId: path.datasetId
      - text: Get features in collection {collection_id} inside bounding box {bbox}.
        slots:
          collection_id: path.collectionId
          bbox: query.bbox
      - text: Find features in {collection_id} matching filter {filter}.
        slots:
          collection_id: path.collectionId
          filter: query.filter
      method: generated
      generated: '2026-10-01'
- target: $.paths['/features/datasets/{datasetId}/collections/{collectionId}/items'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a new feature to a collection
      effect: write
      questions:
      - How do I add a new GeoJSON feature to an indoor map collection?
      - Can I create a feature in my Creator dataset through the API?
      instructions:
      - text: Create feature {feature} in collection {collection_id}.
        slots:
          feature: body.feature
          collection_id: path.collectionId
      - text: Add this new GeoJSON feature {feature} to the {collection_id} collection of dataset {datasetId}.
        slots:
          feature: body.feature
          collection_id: path.collectionId
          datasetId: path.datasetId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/features/datasets/{datasetId}/collections/{collectionId}/items/{featureId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a single feature
      effect: read
      questions:
      - What are the geometry and attributes of one specific feature in my indoor map?
      - Can I fetch a single feature by its id from a collection?
      instructions:
      - text: Show feature {feature_id} from collection {collection_id}.
        slots:
          feature_id: path.featureId
          collection_id: path.collectionId
      - text: Get the details of indoor map feature {feature_id} in {collection_id} of dataset {datasetId}.
        slots:
          feature_id: path.featureId
          collection_id: path.collectionId
          datasetId: path.datasetId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/features/datasets/{datasetId}/collections/{collectionId}/items/{featureId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Replace all attributes of a feature
      effect: write
      questions:
      - How do I overwrite a feature entirely with a new GeoJSON version?
      - Can I replace every attribute of an existing feature in one request?
      instructions:
      - text: Replace feature {feature_id} in collection {collection_id} of dataset {datasetId} with {feature}.
        slots:
          feature_id: path.featureId
          collection_id: path.collectionId
          datasetId: path.datasetId
          feature: body.feature
      - text: Overwrite all of feature {feature_id}'s attributes using the full feature {feature}.
        slots:
          feature_id: path.featureId
          feature: body.feature
      method: generated
      generated: '2026-10-01'
- target: $.paths['/features/datasets/{datasetId}/collections/{collectionId}/items/{featureId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a feature from a collection
      effect: destructive
      questions:
      - How do I remove a feature from my indoor map dataset?
      - Can I delete one feature by id from a Creator collection?
      instructions:
      - text: Delete feature {feature_id} from collection {collection_id}.
        slots:
          feature_id: path.featureId
          collection_id: path.collectionId
      - text: Remove indoor map feature {feature_id} in {collection_id} of dataset {datasetId}.
        slots:
          feature_id: path.featureId
          collection_id: path.collectionId
          datasetId: path.datasetId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/features/datasets/{datasetId}/collections/{collectionId}/items/{featureId}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Modify individual attributes of a feature
      effect: write
      questions:
      - Can I change just one or two attributes of a feature without resending the whole thing?
      - What is the partial-update option for indoor map features?
      instructions:
      - text: Update only these attributes {feature_attributes} on feature {feature_id} in {collection_id} of dataset {datasetId}.
        slots:
          feature_attributes: body.featureAttributes
          feature_id: path.featureId
          collection_id: path.collectionId
          datasetId: path.datasetId
      - text: Patch feature {feature_id} with attribute changes {feature_attributes}.
        slots:
          feature_id: path.featureId
          feature_attributes: body.featureAttributes
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Features/features'].get
  update:
    x-apievangelist-phrasing:
      intent: List all preview features for a subscription
      effect: read
      questions:
      - Which Azure preview features can my subscription opt into?
      - Can I see every AFEC preview feature available across all resource providers?
      instructions:
      - text: List every preview feature available to subscription {subscription_id}.
        slots:
          subscription_id: path.subscriptionId
      - text: Show all AFEC preview features and their state for {subscription_id}.
        slots:
          subscription_id: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Features/providers/{resourceProviderNamespace}/features'].get
  update:
    x-apievangelist-phrasing:
      intent: List preview features in a provider namespace
      effect: read
      questions:
      - What preview features does one resource provider namespace offer my subscription?
      - Which Microsoft.Compute preview features are available to me?
      instructions:
      - text: List preview features in namespace {namespace} for subscription {subscription_id}.
        slots:
          namespace: path.resourceProviderNamespace
          subscription_id: path.subscriptionId
      - text: Show the {namespace} provider's preview features.
        slots:
          namespace: path.resourceProviderNamespace
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Features/providers/{resourceProviderNamespace}/features/{featureName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a preview feature's registration state
      effect: read
      questions:
      - Is a particular preview feature registered on my subscription yet?
      - What state is a named preview feature in for my subscription?
      instructions:
      - text: Check the registration state of preview feature {feature_name} in {namespace} for subscription {subscription_id}.
        slots:
          feature_name: path.featureName
          namespace: path.resourceProviderNamespace
          subscription_id: path.subscriptionId
      - text: Show preview feature {feature_name} under {namespace}.
        slots:
          feature_name: path.featureName
          namespace: path.resourceProviderNamespace
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Features/providers/{resourceProviderNamespace}/features/{featureName}/register'].post
  update:
    x-apievangelist-phrasing:
      intent: Register a preview feature
      effect: write
      questions:
      - How do I opt my subscription into an Azure preview feature?
      - Can I turn on a preview feature for one resource provider through the API?
      instructions:
      - text: Register preview feature {feature_name} in {namespace} for subscription {subscription_id}.
        slots:
          feature_name: path.featureName
          namespace: path.resourceProviderNamespace
          subscription_id: path.subscriptionId
      - text: Opt subscription {subscription_id} into preview feature {feature_name}.
        slots:
          subscription_id: path.subscriptionId
          feature_name: path.featureName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Features/providers/{resourceProviderNamespace}/features/{featureName}/unregister'].post
  update:
    x-apievangelist-phrasing:
      intent: Unregister a preview feature
      effect: destructive
      questions:
      - How do I opt my subscription out of a preview feature I registered?
      - Can I turn a preview feature back off for my subscription?
      instructions:
      - text: Unregister preview feature {feature_name} in {namespace} for subscription {subscription_id}.
        slots:
          feature_name: path.featureName
          namespace: path.resourceProviderNamespace
          subscription_id: path.subscriptionId
      - text: Opt subscription {subscription_id} out of preview feature {feature_name}.
        slots:
          subscription_id: path.subscriptionId
          feature_name: path.featureName
      method: generated
      generated: '2026-09-26'