400: Bad Request
This error can occur for a variety of reasons:

At least one URI or request body parameter is invalid, such as one of the 

The Blueprint token is missing, invalid or expired.

The applicable permissions are needed. For example, this error can occur when:

An Author or Collaborate license is needed for access.

Comment permissions are needed on the artifact.

Edit permissions are needed on the change summary job.

Item is not found in the project. For example, this error can occur when:

User does not have edit permissions for this artifact, project or ALM target.

Reason for failure can be found in the response body. Additional information may also be found in the log.

If the Content-Length header is missing in the request.

If the provided file size is larger than allowed.

If the provided media type is not of MIME Multipart Content "form-data."

points to a part of a collection that is not available.

REST API Requests and Responses

REST API HTTP Status Codes

Equivalent to PAD Flows, UiPath Automations, Blue Prism Processes, or A360 Main Task Bots.

Bots

Analyzes your RPA automation estate and generates effort estimates, complexity insights, and migration sequencing recommendations before conversion begins.

MAP_Migration_Analysis__Planning

GenAI

ALCOnly

Traces define the direction of the relationship between artifacts. A trace is one type of relationship that can exist between artifacts. 

Trace

Blueprint's method for preventing double-charging on repeated imports. Each process is tracked by its original GUID from the source platform — re-importing a modified version of the same process does not consume an additional license

GUID-Based_Duplicate_Handling

A Migrator license consumed on export to PAD. Required to produce a migrated desktop flow or solution file. Licenses are counted per main, not per action or file

Migration_License

Identifies sub-processes used across multiple bots and converts them into shared external desktop flows. Processes that previously inlined the sub-process instead call the shared flow, reducing duplication across the estate

Reuse

User-defined patterns applied automatically during migration — "whenever you see X, do Y." Used to handle custom action mappings, work queue references, missing dependencies, and reuse candidates

Rules

A simulated export to PAD that generates full output — including TODO/INFO/SRC comments and applied Rules — without creating a PAD flow. Used for effort estimation and scoping before committing to a migration

Estimator

A comment Blueprint embeds in generated PAD code containing the original source code, included to reduce ambiguity about the bot's original intent when the generated PAD logic looks different from what the developer expected

A comment Blueprint embeds in generated PAD code to provide helpful context — especially for patterns that change significantly between platforms — without requiring any user action

INFO

A comment Blueprint embeds in generated PAD code to flag something the user must manually resolve before the bot is production-ready. TODOs are categorized by type and are the basis for effort estimation in the Estimator

TODO

A PAD desktop flow generated by Blueprint during migration that wraps or calls shared sub-processes. Blueprint uses wrapper flows to handle reusable components and patterns that don't have a 1:1 equivalent in PAD's native structure

Wrapper_Flow

Blueprint's intermediate format. Imported processes convert to COM before export to PAD. Adding a new source platform requires only a new parser — not a full pipeline re-engineering

COM_Common_Object_Model

Governs PAD flows across their full lifecycle — from ideation and build through to operation and retirement — providing visibility into health, compliance, and change history.

ALC_Automation_Lifecycle_Control

Converts automations from UiPath, Automation Anywhere A360, and Blue Prism to Microsoft Power Automate Desktop (PAD).

Blueprint_Migrator

A process design pattern where execution can jump to different blocks or steps out of sequence — common in Blue Prism and UiPath. PAD enforces mostly linear execution, which is one of the fundamental structural challenges in migration

Non-linear_Workflow

Automation Anywhere's orchestration platform — equivalent to UiPath Orchestrator. Manages bot deployment, scheduling, and monitoring for A360 automations

Control_Room_Automation_Anywhere

Automation Anywhere's cloud-native RPA platform (version A360 / version 11+). One of Blueprint's supported source platforms. Exported as a .zip file containing a manifest.json

Automation_Anywhere_A360

The manifest file in a UiPath package that defines the project structure, dependencies, and entry points. Required when importing a UiPath project into Blueprint Migrator

project.json_UiPath

A leading RPA platform known for its visual workflow editor (XAML-based) and rich ecosystem of activities. UiPath is one of Blueprint's supported source platforms for migration. Exported as a package folder containing a project.json file

UiPath

A reusable library of actions in Blue Prism that abstracts interactions with a specific application (e.g., a 'SAP Business Object'). Analogous to shared libraries or modules in traditional software development

Business_Object_Blue_Prism

The Blue Prism tool used to build and manage UI element definitions (selectors). Elements captured in the Application Modeler form the basis for selector generation during migration to PAD

Application_Modeler_Blue_Prism

The file format used to export processes and objects from Blue Prism. This is the required import file when migrating Blue Prism automations using Blueprint Migrator

.bprelease

An enterprise RPA platform known for its structured, object-oriented approach. Automations are built as process diagrams that call reusable 'objects.' Blue Prism is one of Blueprint's supported source platforms for migration

Blue_Prism

A packaged file format used to export and import one or more PAD desktop flows between environments. Blueprint can export migrated bots as solution files as an alternative to pushing directly to a connected PAD environment

PAD_Solution_File

An automation in Microsoft Power Automate (the cloud product, distinct from PAD) that can trigger and orchestrate desktop flows. Not to be confused with desktop flows themselves

Cloud_Flow_Power_Automate

PAD's term for an RPA automation. Desktop flows can be run directly in PAD or called by a cloud flow in Power Automate

Desktop_Flow_PAD

The underlying scripting language used by Power Automate Desktop. Blueprint generates Robinscript directly when producing migrated PAD flows. Users rarely write Robinscript by hand — PAD generates it via its visual editor

Robinscript

Microsoft's Power Automate Desktop (PAD) RPA tool. It is Blueprint's sole migration target. Automations in PAD are called desktop flows and are written in a scripting language called Robinscript

A sub-process or shared flow that is called by multiple parent processes rather than duplicated. Promoting reuse reduces maintenance overhead and is a key goal of good RPA architecture

Reusable_Component

Automating interactions with Windows desktop applications (as opposed to web or API automation). Relies on UI element selection and is more fragile than API-based automation because it depends on screen layout remaining consistent

Desktop_Automation

A single step within an RPA bot — e.g., Click Button, Read from Excel. Term varies: UiPath (Activities), Blue Prism (Stages), A360 and PAD (Actions)

Action

Logic built into a bot to catch and respond to errors gracefully — retrying, logging, escalating, or recovering — rather than crashing. A critical quality indicator for production-grade automations

Exception_Handling

The boundary within which a variable exists and can be referenced. Source platforms like UiPath and Blue Prism support scoped variables (local to a subflow); Power Automate Desktop treats all variables as global by default until recently

Variable_Scope

The top-level entry point of a call tree — the root process that initiates execution and may call one or more sub-processes. Blueprint Migrator charges licenses by main, not by individual action or process.

Main

The hierarchical structure of a process and all the sub-processes it calls, showing what invokes what. Blueprint uses the call tree as the basis for its licensing unit (a 'main')

Call_Tree

A smaller, modular component called by a parent process. Term varies by platform: UiPath (Sub-processes), A360 (Child Task Bots), Blue Prism (Objects), PAD (Subflows)

Sub-process

A string or expression that uniquely identifies a UI or Web element (button, field, window) on screen so a bot knows what to interact with. Selectors are highly platform-dependent and are one of the most common sources of migration complexity

Selector

A structured list of items that bots process one by one. Work queues allow multiple bots to pull and process items in parallel and are a core pattern for high-volume automations

Work_Queue

A central control platform that manages, schedules, monitors, and deploys RPA bots across an organization. UiPath Orchestrator and Automation Anywhere Control Room are examples

Orchestrator

A bot that runs fully autonomously, typically on a server or virtual machine, without any human involvement. Usually triggered by a schedule or event

Unattended_Automation

A bot that runs on a user's machine and requires human interaction or triggering during execution. The user is present and collaborates with the bot in real time

Attended_Automation

An automated workflow created in an RPA tool. The term varies by platform: UiPath uses Automations or Processes, Automation 360 uses Task Bots, Blue Prism uses Processes, and Power Automate Desktop uses Flows

Process

An automated workflow and its full call tree from the root entry point (Main). Equivalent to a PAD Flow, UiPath Automation, Blue Prism Process, or A360 Main Task Bot.

Robotic Process Automation (RPA) is software technology that uses bots to mimic human interactions with digital systems — clicking, typing, reading screens — to automate repetitive, rule-based tasks without changing underlying applications.