naftiko: 1.0.0-alpha2
info:
  label: Cumulocity Event API — Binaries
  description: Attach, retrieve, and delete binary attachments on Cumulocity events.
  tags: [Cumulocity, Events, Binaries]
  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: event-binaries
    baseUri: '{{env.C8Y_BASE_URL}}'
    resources:
    - name: event-binary
      path: /event/events/{id}/binaries
      operations:
      - name: geteventbinary
        method: GET
        description: Retrieve An Event Binary
        inputParameters:
        - {name: id, in: path, type: string, required: true}
      - name: attacheventbinary
        method: POST
        description: Attach A Binary To An Event
        inputParameters:
        - {name: id, in: path, type: string, required: true}
        - {name: body, in: body, type: object, required: true}
      - name: deleteeventbinary
        method: DELETE
        description: Delete An Event Binary
        inputParameters:
        - {name: id, in: path, type: string, required: true}
    authentication:
      type: basic
      username: '{{env.C8Y_USER}}'
      password: '{{env.C8Y_PASSWORD}}'
  exposes:
  - type: mcp
    namespace: event-binaries-mcp
    port: 9090
    transport: http
    tools:
    - name: cumulocity-get-event-binary
      description: Retrieve the binary attachment of a Cumulocity event.
      hints: {readOnly: true, destructive: false, idempotent: true}
      call: event-binaries.geteventbinary
      with: {id: tools.id}
    - name: cumulocity-attach-event-binary
      description: Attach a binary to a Cumulocity event.
      hints: {readOnly: false, destructive: false, idempotent: false}
      call: event-binaries.attacheventbinary
      with: {id: tools.id, body: tools.body}