Skip to content
Sandbox Agent
GitHub Get Started
HTTP API

Resize a process terminal.

POST
/v1/processes/{id}/terminal/resize

Sets the PTY window size (columns and rows) for a tty-mode process and sends SIGWINCH so the child process can adapt.

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “Path Parameters ”
id
required
string

Process ID

Request Body required

Section titled “Request Body required ”
object
cols
required
integer format: int32
rows
required
integer format: int32

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Resize accepted

object
cols
required
integer format: int32
rows
required
integer format: int32

400

Section titled “400 ”

Invalid request

object
detail
string
nullable
instance
string
nullable
status
required
integer format: int32
title
required
string
type
required
string
key
additional properties

404

Section titled “404 ”

Unknown process

object
detail
string
nullable
instance
string
nullable
status
required
integer format: int32
title
required
string
type
required
string
key
additional properties

409

Section titled “409 ”

Not a terminal process

object
detail
string
nullable
instance
string
nullable
status
required
integer format: int32
title
required
string
type
required
string
key
additional properties

501

Section titled “501 ”

Process API unsupported on this platform

object
detail
string
nullable
instance
string
nullable
status
required
integer format: int32
title
required
string
type
required
string
key
additional properties