Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.hopx.ai/llms.txt

Use this file to discover all available pages before exploring further.

List all running system processes in the sandbox with PID, command, and user information.

​
Endpoint

GET /processes

​
Request

​
Headers

Authorization: Bearer YOUR_JWT_TOKEN

​
Example Request

curl https://sandbox_abc123xyz.hopx.dev/processes \
  -H "Authorization: Bearer YOUR_JWT_TOKEN"

​
Response

​
Success (200 OK)

{
  "processes": [
    {
      "pid": 1,
      "command": "/usr/bin/python3 /app/agent.py",
      "user": "root"
    },
    {
      "pid": 123,
      "command": "python -m http.server 8000",
      "user": "user"
    }
  ],
  "count": 2
}

​
Status Codes

CodeDescription
200Success
401Unauthorized

​
Use Cases

​
Find Specific Process

curl https://sandbox_abc123xyz.hopx.dev/processes \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" | \
  jq '.processes[] | select(.command | contains("python"))'

​
Count Processes

curl https://sandbox_abc123xyz.hopx.dev/processes \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" | jq '.count'

​
Next Steps