Microsoft Entra ID (formerly Azure AD) · OpenAPI Overlay 1.0.0

API Evangelist conversational phrasing for Applications.directory Object API

20 actions 20 updates phrasing extends openapi/azure-ad-applications-directoryobject-api-openapi.yml

Generated by API Evangelist Written by API Evangelist tooling for Microsoft Entra ID (formerly Azure AD)'s API. It is a proposal applied on top of the contract, not a document Microsoft Entra ID (formerly Azure AD) publishes.

View Overlay File View on GitHub Overlay Specification

What the actions change

x-apievangelist-phrasing

Targets 20 · first 16 shown; the file carries all of them

$.info

$.paths['/applications/{application-id}/createdOnBehalfOf'].get

$.paths['/applications/{application-id}/owners'].get

$.paths['/applications/{application-id}/owners/{directoryObject-id}/$ref'].delete

$.paths['/applications/{application-id}/owners/{directoryObject-id}/microsoft.graph.appRoleAssignment'].get

$.paths['/applications/{application-id}/owners/{directoryObject-id}/microsoft.graph.endpoint'].get

$.paths['/applications/{application-id}/owners/{directoryObject-id}/microsoft.graph.servicePrincipal'].get

$.paths['/applications/{application-id}/owners/{directoryObject-id}/microsoft.graph.user'].get

$.paths['/applications/{application-id}/owners/$count'].get

$.paths['/applications/{application-id}/owners/$ref'].get

$.paths['/applications/{application-id}/owners/$ref'].post

$.paths['/applications/{application-id}/owners/$ref'].delete

$.paths['/applications/{application-id}/owners/microsoft.graph.appRoleAssignment'].get

$.paths['/applications/{application-id}/owners/microsoft.graph.appRoleAssignment/$count'].get

$.paths['/applications/{application-id}/owners/microsoft.graph.endpoint'].get

$.paths['/applications/{application-id}/owners/microsoft.graph.endpoint/$count'].get

OpenAPI Overlay

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Applications.directory Object API
  version: 1.0.0
extends: openapi/azure-ad-applications-directoryobject-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: 19
- target: $.paths['/applications/{application-id}/createdOnBehalfOf'].get
  update:
    x-apievangelist-phrasing:
      intent: See who an app registration was created on behalf of
      effect: read
      questions:
      - Which user or object was an Entra app registration created on behalf of?
      - Can I find the directory object that an application was originally registered for?
      instructions:
      - text: Show who application {application} was created on behalf of.
        slots:
          application: path.application-id
      - text: Get the createdOnBehalfOf object for app registration {application}.
        slots:
          application: path.application-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/applications/{application-id}/owners'].get
  update:
    x-apievangelist-phrasing:
      intent: List an application's owners
      effect: read
      questions:
      - Who owns a particular app registration in Microsoft Entra ID?
      - How do I get the full owner objects for an application?
      instructions:
      - text: List the owners of application {application}.
        slots:
          application: path.application-id
      - text: Show me every owner object, with details, for app registration {application}.
        slots:
          application: path.application-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/applications/{application-id}/owners/{directoryObject-id}/$ref'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a specific owner from an application
      effect: destructive
      questions:
      - Can I take a named owner off an app registration by that owner's object ID in the path?
      - What happens if I remove an application owner and leave only one?
      instructions:
      - text: Remove owner {owner} from application {application}.
        slots:
          owner: path.directoryObject-id
          application: path.application-id
      - text: Take directory object {owner} off the owner list of app {application}.
        slots:
          owner: path.directoryObject-id
          application: path.application-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/applications/{application-id}/owners/{directoryObject-id}/microsoft.graph.appRoleAssignment'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an app owner cast as an app role assignment
      effect: read
      questions:
      - Can I read one application owner specifically as an app role assignment object?
      - Is a given owner of my app an appRoleAssignment, and what does it look like?
      instructions:
      - text: Get owner {owner} of application {application} as an app role assignment.
        slots:
          owner: path.directoryObject-id
          application: path.application-id
      - text: Read app {application} owner {owner} typed as appRoleAssignment.
        slots:
          application: path.application-id
          owner: path.directoryObject-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/applications/{application-id}/owners/{directoryObject-id}/microsoft.graph.endpoint'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an app owner cast as an endpoint
      effect: read
      questions:
      - Can I fetch a single application owner typed as an endpoint object?
      - What does an endpoint-type owner of an app registration contain?
      instructions:
      - text: Get owner {owner} of application {application} as an endpoint.
        slots:
          owner: path.directoryObject-id
          application: path.application-id
      - text: Read app {application} owner {owner} typed as endpoint.
        slots:
          application: path.application-id
          owner: path.directoryObject-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/applications/{application-id}/owners/{directoryObject-id}/microsoft.graph.servicePrincipal'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an app owner that is a service principal
      effect: read
      questions:
      - Can I read one of my app's owners as a service principal rather than a generic object?
      - Which service principal details come back for an owner of an application?
      instructions:
      - text: Get owner {owner} of application {application} as a service principal.
        slots:
          owner: path.directoryObject-id
          application: path.application-id
      - text: Show service principal owner {owner} of app {application}.
        slots:
          owner: path.directoryObject-id
          application: path.application-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/applications/{application-id}/owners/{directoryObject-id}/microsoft.graph.user'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an app owner that is a user
      effect: read
      questions:
      - Can I read one of my app's owners as a full user profile?
      - What user details can I get for a specific person who owns an application?
      instructions:
      - text: Get owner {owner} of application {application} as a user.
        slots:
          owner: path.directoryObject-id
          application: path.application-id
      - text: Show the user profile of owner {owner} on app {application}.
        slots:
          owner: path.directoryObject-id
          application: path.application-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/applications/{application-id}/owners/$count'].get
  update:
    x-apievangelist-phrasing:
      intent: Count an application's owners
      effect: read
      questions:
      - How many owners does an app registration have in total?
      - Can I check whether an application has at least two owners?
      instructions:
      - text: Count all owners of application {application}.
        slots:
          application: path.application-id
      - text: Tell me the total owner count for app {application}.
        slots:
          application: path.application-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/applications/{application-id}/owners/$ref'].get
  update:
    x-apievangelist-phrasing:
      intent: List references to an application's owners
      effect: read
      questions:
      - Can I get just the reference links to an app's owners instead of the full objects?
      - Which owner IDs are linked to an application, as $ref entries?
      instructions:
      - text: List the owner references for application {application}.
        slots:
          application: path.application-id
      - text: Give me only the owner $ref links on app {application}.
        slots:
          application: path.application-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/applications/{application-id}/owners/$ref'].post
  update:
    x-apievangelist-phrasing:
      intent: Add an owner to an application
      effect: write
      questions:
      - How do I make a user an owner of an app registration?
      - Can a service principal be added as an owner of an application?
      instructions:
      - text: Add {owner_ref} as an owner of application {application}.
        slots:
          owner_ref: requestBody.@odata.id
          application: path.application-id
      - text: Make the directory object at {owner_ref} a co-owner of app {application}.
        slots:
          owner_ref: requestBody.@odata.id
          application: path.application-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/applications/{application-id}/owners/$ref'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove an app owner by reference ID
      effect: destructive
      questions:
      - Can I remove an application owner by passing the owner's reference as an @id query value?
      - Is there a way to delete an owner link from an app using its $ref URL?
      instructions:
      - text: Remove the owner referenced by {owner_ref} from application {application}.
        slots:
          owner_ref: query.@id
          application: path.application-id
      - text: Delete owner link {owner_ref} on app {application} via its @id reference.
        slots:
          owner_ref: query.@id
          application: path.application-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/applications/{application-id}/owners/microsoft.graph.appRoleAssignment'].get
  update:
    x-apievangelist-phrasing:
      intent: List an app's owners that are app role assignments
      effect: read
      questions:
      - Which of an application's owners are app role assignment objects?
      - Can I filter an app's owner list down to appRoleAssignment types only?
      instructions:
      - text: List the app role assignment owners of application {application}.
        slots:
          application: path.application-id
      - text: Show only appRoleAssignment-typed owners of app {application}.
        slots:
          application: path.application-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/applications/{application-id}/owners/microsoft.graph.appRoleAssignment/$count'].get
  update:
    x-apievangelist-phrasing:
      intent: Count an app's app-role-assignment owners
      effect: read
      questions:
      - How many owners of an application are app role assignments?
      - Can I count the appRoleAssignment-type owners on an app registration?
      instructions:
      - text: Count the app role assignment owners of application {application}.
        slots:
          application: path.application-id
      - text: Tell me how many appRoleAssignment owners app {application} has.
        slots:
          application: path.application-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/applications/{application-id}/owners/microsoft.graph.endpoint'].get
  update:
    x-apievangelist-phrasing:
      intent: List an app's owners that are endpoints
      effect: read
      questions:
      - Which owners of an application are endpoint objects?
      - Can I narrow an app's owner list to endpoint types?
      instructions:
      - text: List the endpoint owners of application {application}.
        slots:
          application: path.application-id
      - text: Show only endpoint-typed owners of app {application}.
        slots:
          application: path.application-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/applications/{application-id}/owners/microsoft.graph.endpoint/$count'].get
  update:
    x-apievangelist-phrasing:
      intent: Count an app's endpoint owners
      effect: read
      questions:
      - How many endpoint-type owners does an application have?
      - Can I get a count of endpoint objects among an app's owners?
      instructions:
      - text: Count the endpoint owners of application {application}.
        slots:
          application: path.application-id
      - text: Tell me how many endpoint owners app {application} has.
        slots:
          application: path.application-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/applications/{application-id}/owners/microsoft.graph.servicePrincipal'].get
  update:
    x-apievangelist-phrasing:
      intent: List an app's owners that are service principals
      effect: read
      questions:
      - Which service principals are listed as owners of my application?
      - Can I see only the non-human owners of an app registration?
      instructions:
      - text: List the service principal owners of application {application}.
        slots:
          application: path.application-id
      - text: Show which service principals own app {application}.
        slots:
          application: path.application-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/applications/{application-id}/owners/microsoft.graph.servicePrincipal/$count'].get
  update:
    x-apievangelist-phrasing:
      intent: Count an app's service principal owners
      effect: read
      questions:
      - How many service principals own a given application?
      - Can I count the service principal owners of an app registration?
      instructions:
      - text: Count the service principal owners of application {application}.
        slots:
          application: path.application-id
      - text: Tell me how many service principals own app {application}.
        slots:
          application: path.application-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/applications/{application-id}/owners/microsoft.graph.user'].get
  update:
    x-apievangelist-phrasing:
      intent: List an app's owners that are users
      effect: read
      questions:
      - Which people are owners of a given app registration?
      - Can I list only the user accounts that own an application?
      instructions:
      - text: List the user owners of application {application}.
        slots:
          application: path.application-id
      - text: Show which people own app {application}.
        slots:
          application: path.application-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/applications/{application-id}/owners/microsoft.graph.user/$count'].get
  update:
    x-apievangelist-phrasing:
      intent: Count an app's user owners
      effect: read
      questions:
      - How many people own a given application?
      - Can I count just the user owners of an app registration?
      instructions:
      - text: Count the user owners of application {application}.
        slots:
          application: path.application-id
      - text: Tell me how many people own app {application}.
        slots:
          application: path.application-id
      method: generated
      generated: '2026-10-01'