Skip to main content
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