Processes

Open terminal session (WebSocket)

Open an interactive terminal (shell) session to a running application process.

This is a WebSocket endpoint. Connect using a WebSocket client with the Upgrade: websocket header. Standard HTTP requests return a 426 Upgrade Required response.

Connection

wscat -c "wss://api.sevalla.com/v3/applications/{id}/processes/{process_id}/terminal?shell=bash" -H "Authorization: Bearer <api_key>"

Authentication runs before the WebSocket upgrade - invalid credentials are rejected with a standard HTTP 401/403 response.

Communication

Once connected, the WebSocket streams stdin/stdout bidirectionally to a shell running inside the container. Send text messages as shell input and receive command output as text messages.

Close codes

4000 - Application or process not found
4001 - No running pod available to connect to
4002 - Shell stream error
4003 - Shell stream closed normally
4005 - Failed to connect to the pod
4300 - Unexpected server error

GET

/

applications

/

{id}

/

processes

/

{process_id}

/

terminal

Open terminal session (WebSocket)

curl --request GET \
  --url https://api.sevalla.com/v3/applications/{id}/processes/{process_id}/terminal \
  --header 'Authorization: Bearer <token>'

{
  "message": "Unauthorized",
  "status": 401,
  "data": {
    "code": "err-abc-123",
    "message": "If you need assistance, please contact support and provide this error code."
  }
}

Authorizations

Authorization

string

header

required

API key authentication. Pass your API key as a Bearer token in the Authorization header.

Path Parameters

id

string<uuid>

required

Application identifier

Pattern:

^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$

Example:

"fb5e5168-4281-4bec-94c5-0d1584e9e657"

process_id

string<uuid>

required

Process identifier

Pattern:

^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$

Example:

"fb5e5168-4281-4bec-94c5-0d1584e9e657"

Query Parameters

shell

enum<string>

default:sh

Shell to use for the terminal session. sh - Bourne shell (default). bash - Bourne Again Shell. dash - Debian Almquist Shell. ksh - KornShell. zsh - Z Shell. csh - C Shell. tcsh - TENEX C Shell.

Available options:

sh,

bash,

dash,

ksh,

zsh,

csh,

tcsh

Response

Default Response

message

string

required

Error message

Example:

"Unauthorized"

status

integer

required

HTTP status code

Required range: -9007199254740991 <= x <= 9007199254740991

Example:

401

data

object

Show child attributes

List deploymentsRetrieve a paginated list of all deployments for an application, ordered by most recent first. Each deployment includes its status, source details, and timestamps.

⌘I

Open terminal session (WebSocket)

curl --request GET \
  --url https://api.sevalla.com/v3/applications/{id}/processes/{process_id}/terminal \
  --header 'Authorization: Bearer <token>'

{
  "message": "Unauthorized",
  "status": 401,
  "data": {
    "code": "err-abc-123",
    "message": "If you need assistance, please contact support and provide this error code."
  }
}