openapi: 3.1.0
info:
  title: Microsoft Graph Admin Admin.admin Application Templates API
  description: 'Microsoft Graph API for managing administrative resources in Microsoft Entra ID.

    This API enables administrators to manage Microsoft Edge browser settings, Internet Explorer mode configurations,

    site lists, shared browser sites, Microsoft 365 Apps installation options, people insights, service announcements,

    SharePoint settings, Copilot administration, directory administrative units, and admin consent policies.'
  version: 1.0.0
  contact:
    name: Microsoft Graph API Support
    url: https://developer.microsoft.com/graph
servers:
- url: https://graph.microsoft.com/v1.0
  description: Microsoft Graph API v1.0 endpoint
tags:
- name: Application Templates
  description: Operations for browsing and instantiating application templates
paths:
  /applicationTemplates:
    description: Provides operations to manage the collection of applicationTemplate entities.
    get:
      tags:
      - Application Templates
      summary: Microsoft Graph List applicationTemplates
      description: Retrieve a list of applicationTemplate objects from the Microsoft Entra application gallery.
      operationId: listApplicationTemplates
      externalDocs:
        description: Find more info here
        url: https://learn.microsoft.com/graph/api/applicationtemplate-list?view=graph-rest-1.0
      parameters:
      - $ref: '#/components/parameters/Top'
      - $ref: '#/components/parameters/Skip'
      - $ref: '#/components/parameters/Search'
      - $ref: '#/components/parameters/Filter'
      - $ref: '#/components/parameters/Count'
      - name: $orderby
        in: query
        description: Order items by property values
        style: form
        explode: false
        schema:
          uniqueItems: true
          type: array
          items:
            type: string
      - name: $select
        in: query
        description: Select properties to be returned
        style: form
        explode: false
        schema:
          uniqueItems: true
          type: array
          items:
            type: string
      - name: $expand
        in: query
        description: Expand related entities
        style: form
        explode: false
        schema:
          uniqueItems: true
          type: array
          items:
            type: string
      responses:
        2XX:
          $ref: '#/components/responses/ApplicationTemplateCollectionResponse'
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
      x-microcks-operation:
        delay: 100
        dispatcher: FALLBACK
        dispatcherRules: 2XX
      x-ms-pageable:
        nextLinkName: '@odata.nextLink'
        operationName: listMore
      x-ms-docs-operation-type: operation
  /applicationTemplates/{applicationTemplate-id}:
    description: Provides operations to manage the collection of applicationTemplate entities.
    parameters:
    - name: applicationTemplate-id
      in: path
      description: The unique identifier of applicationTemplate
      required: true
      schema:
        type: string
      x-ms-docs-key-type: applicationTemplate
    get:
      tags:
      - Application Templates
      summary: Microsoft Graph Get applicationTemplate
      description: Retrieve the properties of an applicationTemplate object.
      operationId: getApplicationTemplates
      externalDocs:
        description: Find more info here
        url: https://learn.microsoft.com/graph/api/applicationtemplate-get?view=graph-rest-1.0
      parameters:
      - name: $select
        in: query
        description: Select properties to be returned
        style: form
        explode: false
        schema:
          uniqueItems: true
          type: array
          items:
            type: string
      - name: $expand
        in: query
        description: Expand related entities
        style: form
        explode: false
        schema:
          uniqueItems: true
          type: array
          items:
            type: string
      responses:
        2XX:
          description: Retrieved entity
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApplicationTemplate'
              examples:
                ApplicationTemplateExample:
                  $ref: '#/components/examples/ApplicationTemplateExample'
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
      x-microcks-operation:
        delay: 100
        dispatcher: FALLBACK
        dispatcherRules: 2XX
      x-ms-docs-operation-type: operation
  /applicationTemplates/$count:
    description: Provides operations to count the resources in the collection.
    get:
      tags:
      - Application Templates
      summary: Microsoft Graph Get the number of the resource
      description: Performs GET operation on /applicationTemplates/$count
      operationId: countApplicationTemplates
      parameters:
      - $ref: '#/components/parameters/Search'
      - $ref: '#/components/parameters/Filter'
      responses:
        2XX:
          $ref: '#/components/responses/ODataCountResponse'
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
      x-microcks-operation:
        delay: 100
        dispatcher: FALLBACK
        dispatcherRules: 2XX
components:
  parameters:
    Top:
      name: $top
      in: query
      description: Show only the first n items
      style: form
      explode: false
      schema:
        minimum: 0
        type: integer
      example: 50
    Skip:
      name: $skip
      in: query
      description: Skip the first n items
      style: form
      explode: false
      schema:
        minimum: 0
        type: integer
    Count:
      name: $count
      in: query
      description: Include count of items
      style: form
      explode: false
      schema:
        type: boolean
    Search:
      name: $search
      in: query
      description: Search items by search phrases
      style: form
      explode: false
      schema:
        type: string
    Filter:
      name: $filter
      in: query
      description: Filter items by property values
      style: form
      explode: false
      schema:
        type: string
  responses:
    ODataCountResponse:
      description: The count of the resource
      content:
        text/plain:
          schema:
            $ref: '#/components/schemas/ODataCountResponse'
          examples:
            ODataCountResponseExample:
              $ref: '#/components/examples/ODataCountResponseExample'
    error:
      description: error
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ODataError'
          examples:
            ODataErrorExample:
              $ref: '#/components/examples/ODataErrorExample'
  schemas:
    InnerError:
      title: InnerError
      type: object
      properties:
        request-id:
          type: string
        date:
          type: string
          format: date-time
        client-request-id:
          type: string
    ApplicationTemplate:
      allOf:
      - $ref: '#/components/schemas/Entity'
      - title: applicationTemplate
        required:
        - '@odata.type'
        type: object
        properties:
          categories:
            type: array
            items:
              type: string
              nullable: true
            description: 'The list of categories for the application. Supported values can be: Collaboration, Business Management, Consumer, Content management, CRM, Data services, Developer services, E-commerce, Education, ERP, Finance, Health, Human resources, IT infrastructure, Mail, Management, Marketing, Media, Productivity, Project management, Telecommunications, Tools, Travel, and Web design & hosting.  Supports $filter (contains).'
          description:
            type: string
            description: A description of the application.
            nullable: true
          displayName:
            type: string
            description: The name of the application. Supports $filter (contains).
            nullable: true
          homePageUrl:
            type: string
            description: The home page URL of the application.
            nullable: true
          logoUrl:
            type: string
            description: The URL to get the logo for this application.
            nullable: true
          publisher:
            type: string
            description: The name of the publisher for this application.
            nullable: true
          supportedProvisioningTypes:
            type: array
            items:
              type: string
              nullable: true
            description: The list of provisioning modes supported by this application. The only valid value is sync.
          supportedSingleSignOnModes:
            type: array
            items:
              type: string
              nullable: true
            description: The list of single sign-on modes supported by this application. The supported values are oidc, password, saml, and notSupported.
          '@odata.type':
            type: string
      x-ms-discriminator-value: '#microsoft.graph.applicationTemplate'
    Entity:
      title: Entity
      type: object
      properties:
        id:
          type: string
          description: The unique identifier for the entity.
    ODataCountResponse:
      title: ODataCountResponse
      type: integer
      format: int32
      description: The count of entities
    ODataError:
      title: ODataError
      type: object
      required:
      - error
      properties:
        error:
          $ref: '#/components/schemas/MainError'
    ErrorDetail:
      title: ErrorDetail
      type: object
      required:
      - code
      - message
      properties:
        code:
          type: string
        message:
          type: string
        target:
          type: string
          nullable: true
    MainError:
      title: MainError
      type: object
      required:
      - code
      - message
      properties:
        code:
          type: string
          description: Error code
        message:
          type: string
          description: Error message
        target:
          type: string
          description: Target of the error
          nullable: true
        details:
          type: array
          items:
            $ref: '#/components/schemas/ErrorDetail'
        innerError:
          $ref: '#/components/schemas/InnerError'
  examples:
    ODataErrorExample:
      value:
        error:
          code: BadRequest
          message: The request is invalid.
          target: /resource
          details:
          - code: InvalidParameter
            message: Parameter value is invalid.
            target: parameterName
          innerError:
            request-id: 00000000-0000-0000-0000-000000000001
            date: '2024-01-15T10:30:00Z'
            client-request-id: 00000000-0000-0000-0000-000000000002
    ODataCountResponseExample:
      value: 42
    ApplicationTemplateExample:
      value:
        id: 00000000-0000-0000-0000-000000000001
        categories:
        - string-value
        description: This is an example description.
        displayName: Example Display Name
        homePageUrl: https://example.com/resource
        logoUrl: https://example.com/resource
        publisher: string-value
        '@odata.type': '#microsoft.graph.applicationtemplate'