Create a long-lived managed process.
Source:
sandbox-agent/docs/content/docs/api-reference/operations/post_v1_processes.mdxCanonical URL: https://rivet.dev/sandbox-agent/docs/api-reference/operations/post_v1_processes Description: POST /v1/processes: request parameters and responses.
POST /v1/processes
Spawns a new process with the given command and arguments. Supports both pipe-based and PTY (tty) modes. Returns the process descriptor on success.
Request body
Required.
application/json
{
"schema": {
"$ref": "#/components/schemas/ProcessCreateRequest"
}
}Related schemas: ProcessCreateRequest.
Responses
200
Started process
Content type: application/json
{
"schema": {
"$ref": "#/components/schemas/ProcessInfo"
}
}Related schemas: ProcessInfo.
400
Invalid request
Content type: application/json
{
"schema": {
"$ref": "#/components/schemas/ProblemDetails"
}
}Related schemas: ProblemDetails.
409
Process limit or state conflict
Content type: application/json
{
"schema": {
"$ref": "#/components/schemas/ProblemDetails"
}
}Related schemas: ProblemDetails.
501
Process API unsupported on this platform
Content type: application/json
{
"schema": {
"$ref": "#/components/schemas/ProblemDetails"
}
}Related schemas: ProblemDetails.