POST
/
computers
/
{id}
/
stream
/
start
curl --request POST \
  --url https://www.orgo.ai/api/computers/{id}/stream/start \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "connection_name": "my-twitch-1"
}'
{
  "success": true,
  "status": "streaming",
  "pid": 12345,
  "start_time": "2023-11-07T05:31:56Z"
}

​
Description

Start streaming the computer’s display to an RTMP server. This allows you to spectate your agent’s computer in real-time through platforms like Twitch, YouTube Live, or custom RTMP servers.

​
Prerequisites

Before using this endpoint, you must:
  1. Configure an RTMP connection in your account settings
  2. Provide the connection name when starting the stream

​
Usage Example

# Start streaming to a configured connection
result = computer.start_stream("my-twitch-1")

# The computer's display is now being streamed
# Do your automation/demo
computer.type("Hello viewers!")
computer.bash("ls -la")

# Stop streaming when done
computer.stop_stream()

​
Connection Configuration

RTMP connections are configured in your account settings with:
  • A unique name (used in this API call)
  • RTMP server URL
  • Stream key (encrypted and stored securely)
  • Optional settings (bitrate, resolution, etc.)

​
Response

The response includes information about the streaming process: 
{
  "success": true,
  "status": "streaming",
  "pid": 12345,
  "start_time": "2024-01-20T10:30:00Z"
}

​
Common Use Cases

  • Live demonstrations of AI agents
  • Recording automation workflows
  • Debugging and monitoring agent behavior
  • Creating content for tutorials or showcases

Authorizations

​
Authorization
string
header
required

API key authentication using Bearer token

Path Parameters

​
id
string
required

Computer/Project name (e.g., computer-abc123)

Body

application/json
​
connection_name
string
required

Name of the pre-configured RTMP connection to use

Example:

"my-twitch-1"

Response

Stream started successfully

​
success
boolean
Example:

true

​
status
enum<string>
Available options:
streaming
Example:

"streaming"

​
pid
integer

Process ID of the ffmpeg streaming process

Example:

12345

​
start_time
string<date-time>

ISO timestamp when the stream started