naftiko: 1.0.0-alpha2
info:
  label: Cumulocity Inventory API — Managed Objects
  description: 'Cumulocity Inventory API — Managed Objects. 5 operations. Lead operation: List Managed Objects.
    Self-contained Naftiko capability covering one Cumulocity business surface.'
  tags:
  - Cumulocity
  - Inventory
  - Managed Objects
  created: '2026-05-25'
  modified: '2026-05-25'
binds:
- namespace: env
  keys:
    C8Y_BASE_URL: C8Y_BASE_URL
    C8Y_USER: C8Y_USER
    C8Y_PASSWORD: C8Y_PASSWORD
capability:
  consumes:
  - type: http
    namespace: inventory-managed-objects
    baseUri: '{{env.C8Y_BASE_URL}}'
    description: Cumulocity Inventory API — Managed Objects business capability. Self-contained.
    resources:
    - name: managed-objects
      path: /inventory/managedObjects
      operations:
      - name: listmanagedobjects
        method: GET
        description: List Managed Objects
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: type
          in: query
          type: string
        - name: fragmentType
          in: query
          type: string
        - name: text
          in: query
          type: string
        - name: pageSize
          in: query
          type: integer
        - name: currentPage
          in: query
          type: integer
      - name: createmanagedobject
        method: POST
        description: Create A Managed Object
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          required: true
    - name: managed-object
      path: /inventory/managedObjects/{id}
      operations:
      - name: getmanagedobject
        method: GET
        description: Retrieve A Managed Object
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          required: true
      - name: updatemanagedobject
        method: PUT
        description: Update A Managed Object
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          required: true
      - name: deletemanagedobject
        method: DELETE
        description: Delete A Managed Object
        inputParameters:
        - name: id
          in: path
          type: string
          required: true
    authentication:
      type: basic
      username: '{{env.C8Y_USER}}'
      password: '{{env.C8Y_PASSWORD}}'
  exposes:
  - type: rest
    namespace: inventory-managed-objects-rest
    port: 8080
    description: REST adapter for Cumulocity Inventory — Managed Objects.
    resources:
    - path: /inventory/managedObjects
      name: managed-objects
      operations:
      - method: GET
        name: listmanagedobjects
        description: List Managed Objects
        call: inventory-managed-objects.listmanagedobjects
        with:
          type: rest.query.type
          fragmentType: rest.query.fragmentType
          text: rest.query.text
          pageSize: rest.query.pageSize
          currentPage: rest.query.currentPage
      - method: POST
        name: createmanagedobject
        description: Create A Managed Object
        call: inventory-managed-objects.createmanagedobject
        with:
          body: rest.body
  - type: mcp
    namespace: inventory-managed-objects-mcp
    port: 9090
    transport: http
    description: MCP adapter for Cumulocity Inventory Managed Objects.
    tools:
    - name: cumulocity-list-managed-objects
      description: List Cumulocity Managed Objects (devices, groups, assets) with optional filters.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: inventory-managed-objects.listmanagedobjects
      with:
        type: tools.type
        fragmentType: tools.fragmentType
        text: tools.text
        pageSize: tools.pageSize
        currentPage: tools.currentPage
    - name: cumulocity-get-managed-object
      description: Retrieve a Cumulocity Managed Object by id.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: inventory-managed-objects.getmanagedobject
      with:
        id: tools.id
    - name: cumulocity-create-managed-object
      description: Create a Cumulocity Managed Object.
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: inventory-managed-objects.createmanagedobject
      with:
        body: tools.body
    - name: cumulocity-update-managed-object
      description: Update a Cumulocity Managed Object by id.
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: inventory-managed-objects.updatemanagedobject
      with:
        id: tools.id
        body: tools.body
    - name: cumulocity-delete-managed-object
      description: Delete a Cumulocity Managed Object by id.
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: inventory-managed-objects.deletemanagedobject
      with:
        id: tools.id