Trimble Agriculture Data API — Equipment Activities

naftiko: 1.0.0-alpha2
info:
  label: Trimble Agriculture Data API — Equipment Activities
  description: 'Trimble Agriculture Data API — Equipment Activities. 3 operations. Lead operation: List Equipment Activities.
    Self-contained Naftiko capability covering one Trimble Agriculture business surface.'
  tags:
  - Trimble Agriculture
  - Equipment Activities
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    TRIMBLE_AGRICULTURE_API_KEY: TRIMBLE_AGRICULTURE_API_KEY
capability:
  consumes:
  - type: http
    namespace: trimble-agriculture-equipment-activities
    baseUri: https://cloud.api.trimble.com/Trimble-Ag-Software/externalApi/3.0
    description: Trimble Agriculture Data API — Equipment Activities business capability. Self-contained, no shared references.
    resources:
    - name: organizations-organizationId-equipmentactivities
      path: /organizations/{organizationId}/equipmentactivities
      operations:
      - name: listequipmentactivities
        method: GET
        description: List Equipment Activities
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: organizationId
          in: path
          type: string
          required: true
        - name: startDate
          in: query
          type: string
          description: Filter activities starting after this time
        - name: endDate
          in: query
          type: string
          description: Filter activities ending before this time
        - name: cropZoneId
          in: query
          type: string
          description: Filter by crop zone
        - name: activityType
          in: query
          type: string
          description: Filter by activity type
    - name: organizations-organizationId-equipmentactivities-activityId
      path: /organizations/{organizationId}/equipmentactivities/{activityId}
      operations:
      - name: getequipmentactivitybyid
        method: GET
        description: Get Equipment Activity
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: organizationId
          in: path
          type: string
          required: true
        - name: activityId
          in: path
          type: string
          required: true
    - name: organizations-organizationId-equipmentactivities-activityId-asapplied
      path: /organizations/{organizationId}/equipmentactivities/{activityId}/asapplied
      operations:
      - name: getasapplieddata
        method: GET
        description: Get As-Applied Data
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: organizationId
          in: path
          type: string
          required: true
        - name: activityId
          in: path
          type: string
          required: true
        - name: format
          in: query
          type: string
          description: Download format
    authentication:
      type: bearer
      token: '{{env.TRIMBLE_AGRICULTURE_API_KEY}}'
  exposes:
  - type: rest
    namespace: trimble-agriculture-equipment-activities-rest
    port: 8080
    description: REST adapter for Trimble Agriculture Data API — Equipment Activities. One Spectral-compliant resource per
      consumed operation, prefixed with /v1.
    resources:
    - path: /v1/organizations/{organizationid}/equipmentactivities
      name: organizations-organizationid-equipmentactivities
      description: REST surface for organizations-organizationId-equipmentactivities.
      operations:
      - method: GET
        name: listequipmentactivities
        description: List Equipment Activities
        call: trimble-agriculture-equipment-activities.listequipmentactivities
        with:
          organizationId: rest.organizationId
          startDate: rest.startDate
          endDate: rest.endDate
          cropZoneId: rest.cropZoneId
          activityType: rest.activityType
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/organizations/{organizationid}/equipmentactivities/{activityid}
      name: organizations-organizationid-equipmentactivities-activityid
      description: REST surface for organizations-organizationId-equipmentactivities-activityId.
      operations:
      - method: GET
        name: getequipmentactivitybyid
        description: Get Equipment Activity
        call: trimble-agriculture-equipment-activities.getequipmentactivitybyid
        with:
          organizationId: rest.organizationId
          activityId: rest.activityId
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/organizations/{organizationid}/equipmentactivities/{activityid}/asapplied
      name: organizations-organizationid-equipmentactivities-activityid-asapplied
      description: REST surface for organizations-organizationId-equipmentactivities-activityId-asapplied.
      operations:
      - method: GET
        name: getasapplieddata
        description: Get As-Applied Data
        call: trimble-agriculture-equipment-activities.getasapplieddata
        with:
          organizationId: rest.organizationId
          activityId: rest.activityId
          format: rest.format
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: trimble-agriculture-equipment-activities-mcp
    port: 9090
    transport: http
    description: MCP adapter for Trimble Agriculture Data API — Equipment Activities. One tool per consumed operation, routed
      inline through this capability's consumes block.
    tools:
    - name: list-equipment-activities
      description: List Equipment Activities
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: trimble-agriculture-equipment-activities.listequipmentactivities
      with:
        organizationId: tools.organizationId
        startDate: tools.startDate
        endDate: tools.endDate
        cropZoneId: tools.cropZoneId
        activityType: tools.activityType
      outputParameters:
      - type: object
        mapping: $.
    - name: get-equipment-activity
      description: Get Equipment Activity
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: trimble-agriculture-equipment-activities.getequipmentactivitybyid
      with:
        organizationId: tools.organizationId
        activityId: tools.activityId
      outputParameters:
      - type: object
        mapping: $.
    - name: get-applied-data
      description: Get As-Applied Data
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: trimble-agriculture-equipment-activities.getasapplieddata
      with:
        organizationId: tools.organizationId
        activityId: tools.activityId
        format: tools.format
      outputParameters:
      - type: object
        mapping: $.