naftiko: 1.0.0-alpha2
info:
  label: UiPath Automation Operations
  description: Unified workflow for automation operators managing robots, jobs, queues, and assets in the UiPath Orchestrator.
    Used by RPA developers and operations teams to deploy, monitor, and manage running automations at scale.
  tags:
  - UiPath
  - Orchestrator
  - Automation Operations
  - RPA
  - Robots
  - Jobs
  created: '2026-05-03'
  modified: '2026-05-06'
binds:
- namespace: env
  keys:
    UIPATH_BEARER_TOKEN: UIPATH_BEARER_TOKEN
capability:
  consumes:
  - type: http
    namespace: orchestrator
    baseUri: https://cloud.uipath.com/{organizationName}/{tenantName}/orchestrator_
    description: UiPath Orchestrator API for managing automation robots, jobs, queues, and assets.
    authentication:
      type: bearer
      token: '{{UIPATH_BEARER_TOKEN}}'
    resources:
    - name: jobs
      path: /odata/Jobs
      description: Manage automation job execution
      operations:
      - name: list-jobs
        method: GET
        description: List automation jobs with filtering
        inputParameters:
        - name: $top
          in: query
          type: integer
          required: false
          description: Maximum number of records to return
        - name: $skip
          in: query
          type: integer
          required: false
          description: Number of records to skip
        - name: $filter
          in: query
          type: string
          required: false
          description: OData filter expression
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: get-job
        method: GET
        description: Get a specific job by key
        inputParameters:
        - name: key
          in: path
          type: integer
          required: true
          description: Job identifier
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: start-jobs
        method: POST
        description: Start one or more automation jobs
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        body:
          type: json
          data:
            startInfo: '{{tools.startInfo}}'
      - name: stop-job
        method: POST
        description: Stop a running automation job
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        body:
          type: json
          data:
            jobId: '{{tools.jobId}}'
    - name: processes
      path: /odata/Processes
      description: Manage automation processes
      operations:
      - name: list-processes
        method: GET
        description: List deployed automation processes
        inputParameters:
        - name: $top
          in: query
          type: integer
          required: false
          description: Maximum number of records
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: queues
      path: /odata/QueueDefinitions
      description: Manage transaction queues
      operations:
      - name: list-queues
        method: GET
        description: List all queue definitions
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: create-queue
        method: POST
        description: Create a new queue definition
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        body:
          type: json
          data:
            Name: '{{tools.queueName}}'
    - name: queue-items
      path: /odata/QueueItems
      description: Manage queue transaction items
      operations:
      - name: list-queue-items
        method: GET
        description: List queue transaction items
        inputParameters:
        - name: $filter
          in: query
          type: string
          required: false
          description: OData filter expression
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: add-queue-item
        method: POST
        description: Add a new item to a queue
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        body:
          type: json
          data:
            itemData: '{{tools.itemData}}'
    - name: assets
      path: /odata/Assets
      description: Manage shared assets like credentials and values
      operations:
      - name: list-assets
        method: GET
        description: List all shared assets
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: create-asset
        method: POST
        description: Create a new shared asset
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        body:
          type: json
          data:
            Name: '{{tools.assetName}}'
            ValueType: '{{tools.valueType}}'
      - name: get-asset
        method: GET
        description: Get a specific asset by key
        inputParameters:
        - name: key
          in: path
          type: integer
          required: true
          description: Asset identifier
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: update-asset
        method: PUT
        description: Update an existing asset
        inputParameters:
        - name: key
          in: path
          type: integer
          required: true
          description: Asset identifier
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        body:
          type: json
          data:
            Value: '{{tools.value}}'
      - name: delete-asset
        method: DELETE
        description: Delete an asset
        inputParameters:
        - name: key
          in: path
          type: integer
          required: true
          description: Asset identifier
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: robots
      path: /odata/Robots
      description: Manage automation robots
      operations:
      - name: list-robots
        method: GET
        description: List all registered robots
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: alerts
      path: /odata/Alerts
      description: Retrieve system and automation alerts
      operations:
      - name: list-alerts
        method: GET
        description: List system alerts and notifications
        inputParameters:
        - name: $filter
          in: query
          type: string
          required: false
          description: OData filter expression
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: webhooks
      path: /odata/Webhooks
      description: Manage webhook subscriptions
      operations:
      - name: list-webhooks
        method: GET
        description: List all webhook subscriptions
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: create-webhook
        method: POST
        description: Create a new webhook subscription
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        body:
          type: json
          data:
            Url: '{{tools.webhookUrl}}'
            EventTypes: '{{tools.eventTypes}}'
      - name: delete-webhook
        method: DELETE
        description: Delete a webhook subscription
        inputParameters:
        - name: key
          in: path
          type: integer
          required: true
          description: Webhook identifier
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
  - type: http
    namespace: data-service
    baseUri: https://cloud.uipath.com/{organizationName}/{tenantName}/dataservice_/api/EntityService
    description: UiPath Data Service API for managing custom data entities and records.
    authentication:
      type: bearer
      token: '{{UIPATH_BEARER_TOKEN}}'
    resources:
    - name: entities
      path: /{entityName}
      description: Manage records for a custom entity
      operations:
      - name: list-entity-records
        method: GET
        description: List records for a specific entity
        inputParameters:
        - name: entityName
          in: path
          type: string
          required: true
          description: Entity name
        - name: $filter
          in: query
          type: string
          required: false
          description: OData filter expression
        - name: $top
          in: query
          type: integer
          required: false
          description: Maximum records to return
        - name: $skip
          in: query
          type: integer
          required: false
          description: Records to skip
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: create-entity-record
        method: POST
        description: Create a new record for an entity
        inputParameters:
        - name: entityName
          in: path
          type: string
          required: true
          description: Entity name
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        body:
          type: json
          data:
            data: '{{tools.recordData}}'
      - name: get-entity-record
        method: GET
        description: Get a specific entity record by ID
        inputParameters:
        - name: entityName
          in: path
          type: string
          required: true
          description: Entity name
        - name: recordId
          in: path
          type: string
          required: true
          description: Record identifier
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: update-entity-record
        method: PUT
        description: Update an existing entity record
        inputParameters:
        - name: entityName
          in: path
          type: string
          required: true
          description: Entity name
        - name: recordId
          in: path
          type: string
          required: true
          description: Record identifier
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        body:
          type: json
          data:
            data: '{{tools.recordData}}'
      - name: delete-entity-record
        method: DELETE
        description: Delete an entity record
        inputParameters:
        - name: entityName
          in: path
          type: string
          required: true
          description: Entity name
        - name: recordId
          in: path
          type: string
          required: true
          description: Record identifier
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: query-entity-records
        method: POST
        description: Query entity records with complex filters
        inputParameters:
        - name: entityName
          in: path
          type: string
          required: true
          description: Entity name
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        body:
          type: json
          data:
            filter: '{{tools.filter}}'
  exposes:
  - type: rest
    port: 8080
    namespace: automation-operations-api
    description: Unified REST API for managing UiPath automation operations including jobs, queues, robots, and assets.
    resources:
    - path: /v1/jobs
      name: jobs
      description: Automation job management
      operations:
      - method: GET
        name: list-jobs
        description: List automation jobs with filtering
        call: orchestrator.list-jobs
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: start-jobs
        description: Start automation jobs
        call: orchestrator.start-jobs
        with:
          startInfo: rest.startInfo
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/robots
      name: robots
      description: Automation robot management
      operations:
      - method: GET
        name: list-robots
        description: List all registered robots
        call: orchestrator.list-robots
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/queues
      name: queues
      description: Transaction queue management
      operations:
      - method: GET
        name: list-queues
        description: List all queue definitions
        call: orchestrator.list-queues
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/queue-items
      name: queue-items
      description: Queue transaction item management
      operations:
      - method: GET
        name: list-queue-items
        description: List queue transaction items
        call: orchestrator.list-queue-items
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: add-queue-item
        description: Add item to queue
        call: orchestrator.add-queue-item
        with:
          itemData: rest.itemData
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/assets
      name: assets
      description: Shared asset management
      operations:
      - method: GET
        name: list-assets
        description: List shared assets
        call: orchestrator.list-assets
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: create-asset
        description: Create a new shared asset
        call: orchestrator.create-asset
        with:
          assetName: rest.assetName
          valueType: rest.valueType
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/alerts
      name: alerts
      description: System and automation alerts
      operations:
      - method: GET
        name: list-alerts
        description: List automation alerts
        call: orchestrator.list-alerts
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/data/{entityName}/records
      name: data-records
      description: Automation data storage records
      operations:
      - method: GET
        name: list-entity-records
        description: List data entity records
        call: data-service.list-entity-records
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    port: 9080
    namespace: automation-operations-mcp
    transport: http
    description: MCP server for AI-assisted automation operations management across UiPath Orchestrator and Data Service.
    tools:
    - name: list-jobs
      description: List automation jobs with optional filtering and pagination
      hints:
        readOnly: true
        openWorld: true
      call: orchestrator.list-jobs
      outputParameters:
      - type: object
        mapping: $.
    - name: start-jobs
      description: Start one or more UiPath automation jobs
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: orchestrator.start-jobs
      with:
        startInfo: tools.startInfo
      outputParameters:
      - type: object
        mapping: $.
    - name: stop-job
      description: Stop a running automation job
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: orchestrator.stop-job
      with:
        jobId: tools.jobId
      outputParameters:
      - type: object
        mapping: $.
    - name: list-robots
      description: List all registered automation robots and their status
      hints:
        readOnly: true
        openWorld: true
      call: orchestrator.list-robots
      outputParameters:
      - type: object
        mapping: $.
    - name: list-queues
      description: List all transaction queue definitions
      hints:
        readOnly: true
        openWorld: true
      call: orchestrator.list-queues
      outputParameters:
      - type: object
        mapping: $.
    - name: add-queue-item
      description: Add a new transaction item to an automation queue
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: orchestrator.add-queue-item
      with:
        itemData: tools.itemData
      outputParameters:
      - type: object
        mapping: $.
    - name: list-assets
      description: List shared automation assets like credentials and variables
      hints:
        readOnly: true
        openWorld: true
      call: orchestrator.list-assets
      outputParameters:
      - type: object
        mapping: $.
    - name: list-alerts
      description: List system and automation alerts for monitoring
      hints:
        readOnly: true
        openWorld: true
      call: orchestrator.list-alerts
      outputParameters:
      - type: object
        mapping: $.
    - name: list-data-records
      description: List records from a Data Service entity
      hints:
        readOnly: true
        openWorld: true
      call: data-service.list-entity-records
      with:
        entityName: tools.entityName
      outputParameters:
      - type: object
        mapping: $.
    - name: create-data-record
      description: Create a new record in a Data Service entity
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: data-service.create-entity-record
      with:
        entityName: tools.entityName
        recordData: tools.recordData
      outputParameters:
      - type: object
        mapping: $.