naftiko: 1.0.0-alpha2
info:
  label: Cumulocity DataHub — Offload Configurations and Jobs
  description: Configure and run Cumulocity DataHub offload pipelines that move operational data from MongoDB to a Parquet data lake.
  tags: [Cumulocity, DataHub, Offload, Data Lake]
  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: datahub-jobs
    baseUri: '{{env.C8Y_BASE_URL}}'
    resources:
    - name: offload
      path: /service/datahub/offload
      operations:
      - name: listoffloadconfigurations
        method: GET
        description: List Offload Configurations
      - name: createoffloadconfiguration
        method: POST
        description: Create An Offload Configuration
        inputParameters:
        - {name: body, in: body, type: object, required: true}
    - name: offload-config
      path: /service/datahub/offload/{id}
      operations:
      - name: getoffloadconfiguration
        method: GET
        description: Retrieve An Offload Configuration
        inputParameters:
        - {name: id, in: path, type: string, required: true}
    - name: offload-jobs
      path: /service/datahub/offload/{id}/jobs
      operations:
      - name: startoffloadjob
        method: POST
        description: Start An Offload Job
        inputParameters:
        - {name: id, in: path, type: string, required: true}
    authentication:
      type: basic
      username: '{{env.C8Y_USER}}'
      password: '{{env.C8Y_PASSWORD}}'
  exposes:
  - type: mcp
    namespace: datahub-jobs-mcp
    port: 9090
    transport: http
    tools:
    - name: cumulocity-list-offload-configurations
      description: List Cumulocity DataHub offload configurations.
      hints: {readOnly: true, destructive: false, idempotent: true}
      call: datahub-jobs.listoffloadconfigurations
      with: {}
    - name: cumulocity-start-offload-job
      description: Start an offload job for a Cumulocity DataHub configuration.
      hints: {readOnly: false, destructive: false, idempotent: false}
      call: datahub-jobs.startoffloadjob
      with: {id: tools.id}