naftiko: 1.0.0-alpha2
info:
  label: UiPath Automation Governance
  description: Unified workflow for automation governance combining Automation Hub for pipeline management, Platform Management
    for user and license administration, and Test Manager for quality assurance. Used by Center of Excellence managers and
    platform administrators overseeing the enterprise automation program.
  tags:
  - UiPath
  - Automation Governance
  - Center of Excellence
  - Platform Administration
  - Licensing
  - Quality Assurance
  created: '2026-05-03'
  modified: '2026-05-06'
binds:
- namespace: env
  keys:
    UIPATH_AUTOMATION_HUB_API_KEY: UIPATH_AUTOMATION_HUB_API_KEY
    UIPATH_BEARER_TOKEN: UIPATH_BEARER_TOKEN
capability:
  consumes:
  - type: http
    namespace: automation-hub
    baseUri: https://cloud.uipath.com/{orgName}/{tenantName}/automationhub_/api/v1
    description: UiPath Automation Hub API for managing automation ideas and pipeline.
    authentication:
      type: apikey
      key: X-Authorization
      value: '{{UIPATH_AUTOMATION_HUB_API_KEY}}'
      placement: header
    resources:
    - name: automations
      path: /automations
      description: Manage automation ideas and projects
      operations:
      - name: list-automations
        method: GET
        description: List automation ideas in the pipeline
        inputParameters:
        - name: phase
          in: query
          type: string
          required: false
          description: Filter by pipeline phase
        - name: status
          in: query
          type: string
          required: false
          description: Filter by status
        - name: page
          in: query
          type: integer
          required: false
          description: Page number
        - name: pageSize
          in: query
          type: integer
          required: false
          description: Results per page
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: create-automation-idea
        method: POST
        description: Submit a new automation idea
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        body:
          type: json
          data:
            name: '{{tools.name}}'
            description: '{{tools.description}}'
      - name: get-automation
        method: GET
        description: Get details of a specific automation
        inputParameters:
        - name: automationId
          in: path
          type: string
          required: true
          description: Automation identifier
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: update-automation
        method: PATCH
        description: Update automation details
        inputParameters:
        - name: automationId
          in: path
          type: string
          required: true
          description: Automation identifier
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        body:
          type: json
          data:
            status: '{{tools.status}}'
      - name: delete-automation
        method: DELETE
        description: Delete an automation idea
        inputParameters:
        - name: automationId
          in: path
          type: string
          required: true
          description: Automation identifier
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: pipeline
      path: /automationpipeline
      description: View the overall automation pipeline
      operations:
      - name: get-automation-pipeline
        method: GET
        description: Get the automation pipeline overview
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: users
      path: /users
      description: Manage Automation Hub users
      operations:
      - name: list-users
        method: GET
        description: List all users in Automation Hub
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
  - type: http
    namespace: platform-management
    baseUri: https://cloud.uipath.com
    description: UiPath Platform Management API for organization and user administration.
    authentication:
      type: bearer
      token: '{{UIPATH_BEARER_TOKEN}}'
    resources:
    - name: users
      path: /{organizationName}/identity_/api/User
      description: Manage organization users
      operations:
      - name: get-user
        method: GET
        description: Get user details by ID
        inputParameters:
        - name: organizationName
          in: path
          type: string
          required: true
          description: Organization name
        - name: userId
          in: path
          type: string
          required: true
          description: User identifier
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: create-user
        method: POST
        description: Create a new user in the organization
        inputParameters:
        - name: organizationName
          in: path
          type: string
          required: true
          description: Organization name
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        body:
          type: json
          data:
            email: '{{tools.email}}'
            name: '{{tools.name}}'
      - name: delete-user
        method: DELETE
        description: Delete a user from the organization
        inputParameters:
        - name: organizationName
          in: path
          type: string
          required: true
          description: Organization name
        - name: userId
          in: path
          type: string
          required: true
          description: User identifier
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: groups
      path: /{organizationName}/identity_/api/Group
      description: Manage organization groups
      operations:
      - name: list-groups
        method: GET
        description: List all groups in the organization
        inputParameters:
        - name: organizationName
          in: path
          type: string
          required: true
          description: Organization name
        - name: partitionGlobalId
          in: path
          type: string
          required: true
          description: Partition global identifier
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: create-group
        method: POST
        description: Create a new group
        inputParameters:
        - name: organizationName
          in: path
          type: string
          required: true
          description: Organization name
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        body:
          type: json
          data:
            name: '{{tools.groupName}}'
    - name: audit
      path: /{organizationName}/orgaudit_/api/query/events
      description: Query organization audit events
      operations:
      - name: query-audit-events
        method: GET
        description: Query organization-level audit events
        inputParameters:
        - name: organizationName
          in: path
          type: string
          required: true
          description: Organization name
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: licenses
      path: /{organizationName}/la/api/account/{accountId}/user-license/group/{groupId}
      description: Manage license allocations
      operations:
      - name: get-group-license-allocation
        method: GET
        description: Get license allocation for a group
        inputParameters:
        - name: organizationName
          in: path
          type: string
          required: true
          description: Organization name
        - name: accountId
          in: path
          type: string
          required: true
          description: Account identifier
        - name: groupId
          in: path
          type: string
          required: true
          description: Group identifier
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
  - type: http
    namespace: test-manager
    baseUri: https://cloud.uipath.com/{organizationName}/{tenantName}/testmanager_
    description: UiPath Test Manager API for managing test projects, cases, sets, and executions.
    authentication:
      type: bearer
      token: '{{UIPATH_BEARER_TOKEN}}'
    resources:
    - name: projects
      path: /api/v2/projects
      description: Manage test projects
      operations:
      - name: list-projects
        method: GET
        description: List all test projects
        inputParameters:
        - name: page
          in: query
          type: integer
          required: false
          description: Page number
        - name: pageSize
          in: query
          type: integer
          required: false
          description: Results per page
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: create-project
        method: POST
        description: Create a new test project
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        body:
          type: json
          data:
            name: '{{tools.projectName}}'
      - name: get-project
        method: GET
        description: Get test project details
        inputParameters:
        - name: projectId
          in: path
          type: string
          required: true
          description: Project identifier
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: test-cases
      path: /api/v2/projects/{projectId}/testcases
      description: Manage test cases within a project
      operations:
      - name: list-test-cases
        method: GET
        description: List test cases in a project
        inputParameters:
        - name: projectId
          in: path
          type: string
          required: true
          description: Project identifier
        - name: page
          in: query
          type: integer
          required: false
          description: Page number
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: create-test-case
        method: POST
        description: Create a new test case
        inputParameters:
        - name: projectId
          in: path
          type: string
          required: true
          description: Project identifier
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        body:
          type: json
          data:
            name: '{{tools.testCaseName}}'
    - name: test-sets
      path: /api/v2/projects/{projectId}/testsets
      description: Manage test sets for grouping test cases
      operations:
      - name: list-test-sets
        method: GET
        description: List test sets in a project
        inputParameters:
        - name: projectId
          in: path
          type: string
          required: true
          description: Project identifier
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: create-test-set
        method: POST
        description: Create a new test set
        inputParameters:
        - name: projectId
          in: path
          type: string
          required: true
          description: Project identifier
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        body:
          type: json
          data:
            name: '{{tools.testSetName}}'
    - name: test-executions
      path: /api/v2/projects/{projectId}/testexecutions
      description: Track test execution results
      operations:
      - name: list-test-executions
        method: GET
        description: List test execution results
        inputParameters:
        - name: projectId
          in: path
          type: string
          required: true
          description: Project identifier
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
  exposes:
  - type: rest
    port: 8082
    namespace: automation-governance-api
    description: Unified REST API for automation governance across Automation Hub, Platform Management, and Test Manager.
    resources:
    - path: /v1/automation-ideas
      name: automation-ideas
      description: Automation idea pipeline management
      operations:
      - method: GET
        name: list-automations
        description: List automation ideas in the pipeline
        call: automation-hub.list-automations
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: create-automation-idea
        description: Submit a new automation idea
        call: automation-hub.create-automation-idea
        with:
          name: rest.name
          description: rest.description
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/pipeline
      name: pipeline
      description: Automation pipeline overview
      operations:
      - method: GET
        name: get-pipeline
        description: Get automation pipeline status
        call: automation-hub.get-automation-pipeline
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/users
      name: users
      description: Platform user management
      operations:
      - method: POST
        name: create-user
        description: Create a platform user
        call: platform-management.create-user
        with:
          email: rest.email
          name: rest.name
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/groups
      name: groups
      description: Platform group management
      operations:
      - method: GET
        name: list-groups
        description: List organization groups
        call: platform-management.list-groups
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/audit-events
      name: audit-events
      description: Organization audit log
      operations:
      - method: GET
        name: query-audit-events
        description: Query audit log events
        call: platform-management.query-audit-events
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/test-projects
      name: test-projects
      description: Test project management
      operations:
      - method: GET
        name: list-test-projects
        description: List test projects
        call: test-manager.list-projects
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/test-executions
      name: test-executions
      description: Test execution results
      operations:
      - method: GET
        name: list-test-executions
        description: List test executions
        call: test-manager.list-test-executions
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    port: 9082
    namespace: automation-governance-mcp
    transport: http
    description: MCP server for AI-assisted automation governance across Automation Hub, Platform Management, and Test Manager.
    tools:
    - name: list-automation-ideas
      description: List automation ideas in the Automation Hub pipeline
      hints:
        readOnly: true
        openWorld: true
      call: automation-hub.list-automations
      outputParameters:
      - type: object
        mapping: $.
    - name: create-automation-idea
      description: Submit a new automation idea to the Automation Hub pipeline
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: automation-hub.create-automation-idea
      with:
        name: tools.name
        description: tools.description
      outputParameters:
      - type: object
        mapping: $.
    - name: get-automation-pipeline
      description: Get the overall automation pipeline status and metrics
      hints:
        readOnly: true
        openWorld: true
      call: automation-hub.get-automation-pipeline
      outputParameters:
      - type: object
        mapping: $.
    - name: get-user
      description: Get details of an organization user
      hints:
        readOnly: true
        openWorld: true
      call: platform-management.get-user
      with:
        userId: tools.userId
      outputParameters:
      - type: object
        mapping: $.
    - name: create-user
      description: Create a new user in the UiPath organization
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: platform-management.create-user
      with:
        email: tools.email
        name: tools.name
      outputParameters:
      - type: object
        mapping: $.
    - name: list-groups
      description: List organization groups and memberships
      hints:
        readOnly: true
        openWorld: true
      call: platform-management.list-groups
      outputParameters:
      - type: object
        mapping: $.
    - name: query-audit-events
      description: Query organization audit log for compliance and governance
      hints:
        readOnly: true
        openWorld: true
      call: platform-management.query-audit-events
      outputParameters:
      - type: object
        mapping: $.
    - name: get-license-allocation
      description: Get license allocation for an organization group
      hints:
        readOnly: true
        openWorld: true
      call: platform-management.get-group-license-allocation
      outputParameters:
      - type: object
        mapping: $.
    - name: list-test-projects
      description: List test projects for QA governance
      hints:
        readOnly: true
        openWorld: true
      call: test-manager.list-projects
      outputParameters:
      - type: object
        mapping: $.
    - name: list-test-executions
      description: List test execution history for quality reporting
      hints:
        readOnly: true
        openWorld: true
      call: test-manager.list-test-executions
      outputParameters:
      - type: object
        mapping: $.
    - name: create-test-case
      description: Create a new test case in a test project
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: test-manager.create-test-case
      with:
        projectId: tools.projectId
        testCaseName: tools.testCaseName
      outputParameters:
      - type: object
        mapping: $.