Microsoft Azure API Client — Providers

naftiko: 1.0.0-alpha2
info:
  label: Microsoft Azure API Client — Providers
  description: 'Microsoft Azure API Client — Providers. 5 operations. Lead operation: Microsoft Azure Gets Publishing User.
    Self-contained Naftiko capability covering one Microsoft Azure business surface.'
  tags:
  - Microsoft Azure
  - Providers
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    MICROSOFT_AZURE_API_KEY: MICROSOFT_AZURE_API_KEY
capability:
  consumes:
  - type: http
    namespace: api-client-providers
    baseUri: https://management.azure.com
    description: Microsoft Azure API Client — Providers business capability. Self-contained, no shared references.
    resources:
    - name: providers-Microsoft.Web-publishingUsers-web
      path: /providers/Microsoft.Web/publishingUsers/web
      operations:
      - name: microsoftazuregetpublishinguser
        method: GET
        description: Microsoft Azure Gets Publishing User
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: microsoftazureupdatepublishinguser
        method: PUT
        description: Microsoft Azure Updates Publishing User
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: userDetails
          in: body
          type: string
          description: Details of publishing user
          required: true
    - name: providers-Microsoft.Web-sourcecontrols
      path: /providers/Microsoft.Web/sourcecontrols
      operations:
      - name: microsoftazurelistsourcecontrols
        method: GET
        description: Microsoft Azure Gets The Source Controls Available For Azure Websites
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: providers-Microsoft.Web-sourcecontrols-sourceControlType
      path: /providers/Microsoft.Web/sourcecontrols/{sourceControlType}
      operations:
      - name: microsoftazuregetsourcecontrol
        method: GET
        description: Microsoft Azure Gets Source Control Token
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: sourceControlType
          in: path
          type: string
          description: Type of source control
          required: true
      - name: microsoftazureupdatesourcecontrol
        method: PUT
        description: Microsoft Azure Updates Source Control Token
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: sourceControlType
          in: path
          type: string
          description: Type of source control
          required: true
        - name: requestMessage
          in: body
          type: string
          description: Source control token information
          required: true
  exposes:
  - type: rest
    namespace: api-client-providers-rest
    port: 8080
    description: REST adapter for Microsoft Azure API Client — Providers. One Spectral-compliant resource per consumed operation,
      prefixed with /v1.
    resources:
    - path: /v1/providers/microsoft-web/publishingusers/web
      name: providers-microsoft-web-publishingusers-web
      description: REST surface for providers-Microsoft.Web-publishingUsers-web.
      operations:
      - method: GET
        name: microsoftazuregetpublishinguser
        description: Microsoft Azure Gets Publishing User
        call: api-client-providers.microsoftazuregetpublishinguser
        outputParameters:
        - type: object
          mapping: $.
      - method: PUT
        name: microsoftazureupdatepublishinguser
        description: Microsoft Azure Updates Publishing User
        call: api-client-providers.microsoftazureupdatepublishinguser
        with:
          userDetails: rest.userDetails
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/providers/microsoft-web/sourcecontrols
      name: providers-microsoft-web-sourcecontrols
      description: REST surface for providers-Microsoft.Web-sourcecontrols.
      operations:
      - method: GET
        name: microsoftazurelistsourcecontrols
        description: Microsoft Azure Gets The Source Controls Available For Azure Websites
        call: api-client-providers.microsoftazurelistsourcecontrols
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/providers/microsoft-web/sourcecontrols/{sourcecontroltype}
      name: providers-microsoft-web-sourcecontrols-sourcecontroltype
      description: REST surface for providers-Microsoft.Web-sourcecontrols-sourceControlType.
      operations:
      - method: GET
        name: microsoftazuregetsourcecontrol
        description: Microsoft Azure Gets Source Control Token
        call: api-client-providers.microsoftazuregetsourcecontrol
        with:
          sourceControlType: rest.sourceControlType
        outputParameters:
        - type: object
          mapping: $.
      - method: PUT
        name: microsoftazureupdatesourcecontrol
        description: Microsoft Azure Updates Source Control Token
        call: api-client-providers.microsoftazureupdatesourcecontrol
        with:
          sourceControlType: rest.sourceControlType
          requestMessage: rest.requestMessage
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: api-client-providers-mcp
    port: 9090
    transport: http
    description: MCP adapter for Microsoft Azure API Client — Providers. One tool per consumed operation, routed inline through
      this capability's consumes block.
    tools:
    - name: microsoft-azure-gets-publishing-user
      description: Microsoft Azure Gets Publishing User
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: api-client-providers.microsoftazuregetpublishinguser
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-updates-publishing-user
      description: Microsoft Azure Updates Publishing User
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: api-client-providers.microsoftazureupdatepublishinguser
      with:
        userDetails: tools.userDetails
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-gets-source-controls
      description: Microsoft Azure Gets The Source Controls Available For Azure Websites
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: api-client-providers.microsoftazurelistsourcecontrols
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-gets-source-control
      description: Microsoft Azure Gets Source Control Token
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: api-client-providers.microsoftazuregetsourcecontrol
      with:
        sourceControlType: tools.sourceControlType
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-updates-source-control
      description: Microsoft Azure Updates Source Control Token
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: api-client-providers.microsoftazureupdatesourcecontrol
      with:
        sourceControlType: tools.sourceControlType
        requestMessage: tools.requestMessage
      outputParameters:
      - type: object
        mapping: $.