GET
/
computers
/
{id}
/
stream
/
status
Get Stream Status
curl --request GET \
  --url https://www.orgo.ai/api/computers/{id}/stream/status \
  --header 'Authorization: Bearer <token>'
{
  "status": "streaming",
  "start_time": "2024-01-20T10:30:00Z",
  "pid": 12345
}

​
Description

Check the current streaming status of a computer. This endpoint allows you to verify if a stream is active, when it started, and get the process information.

​
Usage Example

# Check if streaming is active
status = computer.stream_status()

if status['status'] == 'streaming':
    print(f"Stream active since: {status['start_time']}")
    print(f"Process ID: {status['pid']}")
elif status['status'] == 'idle':
    print("No active stream")

​
Response Format

​
When Streaming

{
  "status": "streaming",
  "start_time": "2024-01-20T10:30:00Z",
  "pid": 12345
}

​
When Idle

{
  "status": "idle"
}

​
When Terminated

{
  "status": "terminated",
  "message": "Stream process was terminated unexpectedly"
}

​
Status Values

  • idle - No active stream
  • streaming - Stream is currently active
  • terminated - Stream process ended unexpectedly

​
Common Use Cases

  • Monitoring stream health
  • Verifying stream started successfully
  • Detecting unexpected stream termination
  • Building stream status dashboards

Authorizations

​
Authorization
string
header
required

API key authentication using Bearer token

Path Parameters

​
id
string
required

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

Response

Stream status retrieved successfully

​
status
enum<string>

Current stream status

Available options:
idle,
streaming,
terminated
​
start_time
string<date-time>

ISO timestamp when stream started (only present when streaming)

​
pid
integer

Process ID of ffmpeg (only present when streaming)

​
message
string

Additional status message (only present for terminated status)