POST /api/ide/terminal

Part of the API reference; this page is generated from the OpenAPI document that the gateway builds from its own route tables.

Provenance

• Contract version: 1.10.0
• Contract title: acumen gateway API
• Source: acumen:docs/openapi/acumen-v1.openapi.json

Operations

POST /api/ide/terminal

Open a PTY terminal

Opens a PTY in the workspace root and returns its terminal id and stream URL. Capped by maxTerminals. Operator (admin) scope.

• Operation id: postApiIdeTerminal
• Scope: admin
• Exposure: operator
• Mutating: no
• Auth: bearerAuth, operatorSession

Request

• Request body (application/json, required): IDETerminalCreateRequest: IDETerminalCreateRequest (object)

Field	Type	Required	Notes
cols	integer	no
rows	integer	no

Responses

• 200: terminal created
  • application/json: IDEEnvelope: IDEEnvelope (object)
• 409: terminal_limit
  • application/problem+json: Problem: Problem (object)