robocorp-workitems

What it is and what it does

robocorp-workitems is a library for managing data that flows through multi-step robotic processes in Robocorp Control Room. It provides two main interfaces—`inputs` for reading work items from a queue and `outputs` for creating new work items—allowing robots to consume data from one step and produce data for the next. Each work item contains a JSON payload (key-value pairs) and can optionally include files stored within Control Room.

The library is designed to integrate with robocorp-tasks for task decoration and uses requests and tenacity for HTTP communication and retry logic. It supports iterating over all available input items or accessing the current item, and allows modification of inputs and exception-based flow control. Local development is supported, and the library handles file attachment management transparently.

Use it for:

• Read input work items from Control Room queue, process data, and create output items for downstream steps in a multi-step automation.
• Iterate over batches of work items to perform bulk operations such as data transformation or validation across a queue.
• Attach files to output work items for downstream tasks to consume, such as generated reports or processed data files.
• Implement error handling and flow control by reserving, modifying, or releasing work items based on task outcomes.
• Develop and test robotic processes locally using work item APIs before deploying to Control Room.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Manages data flow through multi-step robotic processes by reading input work items and creating output work items for queues in Robocorp Control Room.

Yes. Active maintenance, low install friction, permissive license, no known vulnerabilities, and tight integration with Robocorp's automation platform make this a solid choice for building multi-step robotic processes. Install if you are building workflows in Robocorp Control Room or developing robots that need to consume and produce queued work items.

Install

robocorp-workitems on PyPI

pip install robocorp-workitems

uv add robocorp-workitems

poetry add robocorp-workitems

Installing robocorp-workitems

Before you install

Low install friction with a pure-Python wheel. Actively maintained with recent releases and a stable dependency set including robocorp-tasks, requests, and tenacity for retry logic.

License in practice

Apache-2.0 permissive license allows use in commercial and open-source projects with minimal restrictions; attribution required.

Quickstart

pip install robocorp-workitems

from robocorp import workitems
from robocorp.tasks import task

@task
def handle_item():
    item = workitems.inputs.current
    print("Received payload:", item.payload)
    workitems.outputs.create(payload={"key": "value"})

Requires Python 3.10 or later; designed to run within Robocorp Control Room or local development environment with work item context.

Verify before relying

• Whether local development mode fully replicates Control Room work item behavior without a running instance.
• Performance characteristics when handling large numbers of work items or large file attachments.
• Retry and error-handling semantics when work item operations fail mid-process.

Package facts

Evidence: robocorp_workitems-1.5.0-py3-none-any.whl

Tags

More Application Frameworks packages