Microsoft Azure Azure App Configuration — KeyValues

naftiko: 1.0.0-alpha2
info:
  label: Microsoft Azure Azure App Configuration — KeyValues
  description: 'Microsoft Azure Azure App Configuration — KeyValues. 6 operations. Lead operation: Microsoft Azure Gets A
    List Of Key Values. Self-contained Naftiko capability covering one Microsoft Azure business surface.'
  tags:
  - Microsoft Azure
  - KeyValues
  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: azure-app-configuration-keyvalues
    baseUri: ''
    description: Microsoft Azure Azure App Configuration — KeyValues business capability. Self-contained, no shared references.
    resources:
    - name: kv
      path: /kv
      operations:
      - name: microsoftazuregetkeyvalues
        method: GET
        description: Microsoft Azure Gets A List Of Key Values
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: key
          in: query
          type: string
          description: A filter used to match keys.
        - name: label
          in: query
          type: string
          description: A filter used to match labels
        - name: After
          in: query
          type: string
          description: Instructs the server to return elements that appear after the element referred to by the specified
            token.
        - name: Accept-Datetime
          in: header
          type: string
          description: Requests the server to respond with the state of the resource at the specified time.
        - name: snapshot
          in: query
          type: string
          description: A filter used get key-values for a snapshot. The value should be the name of the snapshot. Not valid
            when used with 'key' and 'label' filters.
      - name: microsoftazurecheckkeyvalues
        method: HEAD
        description: Microsoft Azure Requests The Headers And Status Of The Given Resource
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: key
          in: query
          type: string
          description: A filter used to match keys.
        - name: label
          in: query
          type: string
          description: A filter used to match labels
        - name: After
          in: query
          type: string
          description: Instructs the server to return elements that appear after the element referred to by the specified
            token.
        - name: Accept-Datetime
          in: header
          type: string
          description: Requests the server to respond with the state of the resource at the specified time.
        - name: snapshot
          in: query
          type: string
          description: A filter used get key-values for a snapshot. Not valid when used with 'key' and 'label' filters.
    - name: kv-key
      path: /kv/{key}
      operations:
      - name: microsoftazuregetkeyvalue
        method: GET
        description: Microsoft Azure Gets A Single Key Value
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: key
          in: path
          type: string
          description: The key of the key-value to retrieve.
          required: true
        - name: label
          in: query
          type: string
          description: The label of the key-value to retrieve.
        - name: Accept-Datetime
          in: header
          type: string
          description: Requests the server to respond with the state of the resource at the specified time.
        - name: If-Match
          in: header
          type: string
          description: Used to perform an operation only if the targeted resource's etag matches the value provided.
        - name: If-None-Match
          in: header
          type: string
          description: Used to perform an operation only if the targeted resource's etag does not match the value provided.
      - name: microsoftazureputkeyvalue
        method: PUT
        description: Microsoft Azure Creates A Key Value
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: key
          in: path
          type: string
          description: The key of the key-value to create.
          required: true
        - name: label
          in: query
          type: string
          description: The label of the key-value to create.
        - name: entity
          in: body
          type: string
          description: The key-value to create.
        - name: If-Match
          in: header
          type: string
          description: Used to perform an operation only if the targeted resource's etag matches the value provided.
        - name: If-None-Match
          in: header
          type: string
          description: Used to perform an operation only if the targeted resource's etag does not match the value provided.
      - name: microsoftazuredeletekeyvalue
        method: DELETE
        description: Microsoft Azure Deletes A Key Value
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: key
          in: path
          type: string
          description: The key of the key-value to delete.
          required: true
        - name: label
          in: query
          type: string
          description: The label of the key-value to delete.
        - name: If-Match
          in: header
          type: string
          description: Used to perform an operation only if the targeted resource's etag matches the value provided.
      - name: microsoftazurecheckkeyvalue
        method: HEAD
        description: Microsoft Azure Requests The Headers And Status Of The Given Resource
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: key
          in: path
          type: string
          description: The key of the key-value to retrieve.
          required: true
        - name: label
          in: query
          type: string
          description: The label of the key-value to retrieve.
        - name: Accept-Datetime
          in: header
          type: string
          description: Requests the server to respond with the state of the resource at the specified time.
        - name: If-Match
          in: header
          type: string
          description: Used to perform an operation only if the targeted resource's etag matches the value provided.
        - name: If-None-Match
          in: header
          type: string
          description: Used to perform an operation only if the targeted resource's etag does not match the value provided.
  exposes:
  - type: rest
    namespace: azure-app-configuration-keyvalues-rest
    port: 8080
    description: REST adapter for Microsoft Azure Azure App Configuration — KeyValues. One Spectral-compliant resource per
      consumed operation, prefixed with /v1.
    resources:
    - path: /v1/kv
      name: kv
      description: REST surface for kv.
      operations:
      - method: GET
        name: microsoftazuregetkeyvalues
        description: Microsoft Azure Gets A List Of Key Values
        call: azure-app-configuration-keyvalues.microsoftazuregetkeyvalues
        with:
          key: rest.key
          label: rest.label
          After: rest.After
          Accept-Datetime: rest.Accept-Datetime
          snapshot: rest.snapshot
        outputParameters:
        - type: object
          mapping: $.
      - method: HEAD
        name: microsoftazurecheckkeyvalues
        description: Microsoft Azure Requests The Headers And Status Of The Given Resource
        call: azure-app-configuration-keyvalues.microsoftazurecheckkeyvalues
        with:
          key: rest.key
          label: rest.label
          After: rest.After
          Accept-Datetime: rest.Accept-Datetime
          snapshot: rest.snapshot
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/kv/{key}
      name: kv-key
      description: REST surface for kv-key.
      operations:
      - method: GET
        name: microsoftazuregetkeyvalue
        description: Microsoft Azure Gets A Single Key Value
        call: azure-app-configuration-keyvalues.microsoftazuregetkeyvalue
        with:
          key: rest.key
          label: rest.label
          Accept-Datetime: rest.Accept-Datetime
          If-Match: rest.If-Match
          If-None-Match: rest.If-None-Match
        outputParameters:
        - type: object
          mapping: $.
      - method: PUT
        name: microsoftazureputkeyvalue
        description: Microsoft Azure Creates A Key Value
        call: azure-app-configuration-keyvalues.microsoftazureputkeyvalue
        with:
          key: rest.key
          label: rest.label
          entity: rest.entity
          If-Match: rest.If-Match
          If-None-Match: rest.If-None-Match
        outputParameters:
        - type: object
          mapping: $.
      - method: DELETE
        name: microsoftazuredeletekeyvalue
        description: Microsoft Azure Deletes A Key Value
        call: azure-app-configuration-keyvalues.microsoftazuredeletekeyvalue
        with:
          key: rest.key
          label: rest.label
          If-Match: rest.If-Match
        outputParameters:
        - type: object
          mapping: $.
      - method: HEAD
        name: microsoftazurecheckkeyvalue
        description: Microsoft Azure Requests The Headers And Status Of The Given Resource
        call: azure-app-configuration-keyvalues.microsoftazurecheckkeyvalue
        with:
          key: rest.key
          label: rest.label
          Accept-Datetime: rest.Accept-Datetime
          If-Match: rest.If-Match
          If-None-Match: rest.If-None-Match
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: azure-app-configuration-keyvalues-mcp
    port: 9090
    transport: http
    description: MCP adapter for Microsoft Azure Azure App Configuration — KeyValues. One tool per consumed operation, routed
      inline through this capability's consumes block.
    tools:
    - name: microsoft-azure-gets-list-key
      description: Microsoft Azure Gets A List Of Key Values
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: azure-app-configuration-keyvalues.microsoftazuregetkeyvalues
      with:
        key: tools.key
        label: tools.label
        After: tools.After
        Accept-Datetime: tools.Accept-Datetime
        snapshot: tools.snapshot
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-requests-headers-and
      description: Microsoft Azure Requests The Headers And Status Of The Given Resource
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: azure-app-configuration-keyvalues.microsoftazurecheckkeyvalues
      with:
        key: tools.key
        label: tools.label
        After: tools.After
        Accept-Datetime: tools.Accept-Datetime
        snapshot: tools.snapshot
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-gets-single-key
      description: Microsoft Azure Gets A Single Key Value
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: azure-app-configuration-keyvalues.microsoftazuregetkeyvalue
      with:
        key: tools.key
        label: tools.label
        Accept-Datetime: tools.Accept-Datetime
        If-Match: tools.If-Match
        If-None-Match: tools.If-None-Match
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-creates-key-value
      description: Microsoft Azure Creates A Key Value
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: azure-app-configuration-keyvalues.microsoftazureputkeyvalue
      with:
        key: tools.key
        label: tools.label
        entity: tools.entity
        If-Match: tools.If-Match
        If-None-Match: tools.If-None-Match
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-deletes-key-value
      description: Microsoft Azure Deletes A Key Value
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: azure-app-configuration-keyvalues.microsoftazuredeletekeyvalue
      with:
        key: tools.key
        label: tools.label
        If-Match: tools.If-Match
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-requests-headers-and-2
      description: Microsoft Azure Requests The Headers And Status Of The Given Resource
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: azure-app-configuration-keyvalues.microsoftazurecheckkeyvalue
      with:
        key: tools.key
        label: tools.label
        Accept-Datetime: tools.Accept-Datetime
        If-Match: tools.If-Match
        If-None-Match: tools.If-None-Match
      outputParameters:
      - type: object
        mapping: $.