What is the primary use of the OpenHands API skill?

It is used to programmatically control OpenHands Cloud, allowing users to start, monitor, and manage AI conversations and sandboxes via the V1 REST API.

How many delegated conversations can I run at once?

The skill suggests a limit of 5 concurrently running conversations to ensure optimal performance and manageable monitoring.

Can I use this skill for local sandbox tasks?

No, this skill is specifically designed for interacting with the OpenHands Cloud REST API and is not intended for general local development tasks.

What authentication is required for the OpenHands API?

It primarily uses Bearer authentication with an OPENHANDS_CLOUD_API_KEY for the app server, and session-specific keys for internal agent-server interactions.

How does the delegation pattern work in this skill?

Delegation allows you to trigger a separate OpenHands conversation for a specific sub-task (like fixing a bug or running tests) to keep your main context window clean and focused.

OpenHands Cloud API Manager

Name: OpenHands Cloud API Manager
Author: OpenHands

byOpenHands

•

API Development

Automates OpenHands Cloud workflows by managing conversations, monitoring execution status, and delegating parallel tasks via the REST API.

The OpenHands Cloud API skill enables developers to programmatically interact with the OpenHands ecosystem, facilitating advanced workflows such as automated conversation management and multi-agent work delegation. It provides a structured interface for starting new cloud-based AI sessions, polling for task completion, and accessing sandbox agent servers directly. This skill is ideal for orchestrating complex, multi-stage development tasks where fresh context windows or parallel background processing are required to maintain high developer productivity and focus.

Key Features

01Automated conversation creation and management

02Asynchronous task monitoring and status polling

03Direct sandbox agent-server interaction via session keys

0475 GitHub stars

05Multi-conversation delegation for parallel background work

06Detailed event inspection and trajectory log retrieval

Use Cases

01Automating the monitoring and reporting of long-running OpenHands Cloud jobs

02Programmatically retrieving conversation event histories for debugging and analysis

03Delegating sub-tasks like unit testing or component building to fresh background conversations

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add openhands/extensions openhands-api

For use in Claude.ai and ChatGPT

Download Skill