Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Replicas Terminal API

Manage interactive terminal sessions in active workspaces

Replicas Terminal API is one of 13 APIs that Replicas publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Terminal. The published artifact set on APIs.io includes an OpenAPI specification.

This API exposes 6 operations across 5 paths, and defines 8 schemas. It is described by OpenAPI 3.1.0, at version 2.0.0.

Requests are made against a single base URL, https://api.tryreplicas.com.

6 operations 5 paths 8 schemas 1 DELETE2 GET3 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
2.0.0
Base URL
https://api.tryreplicas.com
Authentication
HTTP Bearer, HTTP Bearer, API Key
Resource Areas
1

Authentication & Security 3

Replicas Terminal API declares 3 security schemes for authenticating requests. It accepts HTTP bearer tokens (apiKey). It accepts HTTP bearer tokens (engineSecret). An API key is passed in the header as X-Workspace-Id (workspaceId). By default, every request must be authenticated.

  • apiKey — API key authentication. Obtain your API key from the Replicas dashboard under Organization → Settings → API Keys.
  • engineSecret — Workspace engine secret used by agent-mode workspace requests.
  • workspaceId — Workspace ID used with the engine secret for agent-mode workspace requests.

Paths & Operations 6

Across 5 paths, the API surfaces 6 operations — 1 DELETE, 2 GET, 3 POST. Each is listed below with its method, path, parameters, and response codes.

Terminal 6

Manage interactive terminal sessions in active workspaces

GET
/v1/workspaces/{workspaceId}/terminal/sessions
List Terminal Sessions
listWorkspaceTerminalSessions 1 param → 200401404500
POST
/v1/workspaces/{workspaceId}/terminal/sessions
Create Terminal Session
createWorkspaceTerminalSession 1 param body → 201400401404429500
POST
/v1/workspaces/{workspaceId}/terminal/sessions/{sessionId}/input
Write Terminal Input
writeWorkspaceTerminalSession 2 params body → 200400401404500
POST
/v1/workspaces/{workspaceId}/terminal/sessions/{sessionId}/resize
Resize Terminal Session
resizeWorkspaceTerminalSession 2 params body → 200400401404500
DELETE
/v1/workspaces/{workspaceId}/terminal/sessions/{sessionId}
Delete Terminal Session
deleteWorkspaceTerminalSession 2 params → 200401404500
GET
/v1/workspaces/{workspaceId}/terminal/sessions/{sessionId}/stream
Stream Terminal Output
streamWorkspaceTerminalSession 2 params → 200401404500

Schemas 8

The contract defines 8 schemas that model the data the API accepts and returns. The most detailed are TerminalSession (5 properties), WriteTerminalSessionRequest (3 properties), CreateTerminalSessionRequest (2 properties), ResizeTerminalSessionRequest (2 properties). Each schema is shown below with its type and property counts.

ResizeTerminalSessionRequest
object
2 properties 2 required
WriteTerminalSessionRequest
object
3 properties 3 required
TerminalMutationResponse
object
1 property 1 required
CreateTerminalSessionResponse
object
1 property 1 required
Error
object
2 properties 1 required
TerminalSession
object
5 properties 4 required
CreateTerminalSessionRequest
object
2 properties 2 required
ListTerminalSessionsResponse
object
1 property 1 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

replicas-terminal-api-openapi.yml Raw ↑

Other APIs Replicas publishes across the network.

Replicas Analytics API
Replicas API Keys API
Replicas Automation API
Replicas Credentials API
Replicas Downloads API
Replicas Environments API
Replicas Google Search Console API
Replicas Preview API
Replicas Profile API
Replicas Replica API
Replicas Repository API
Replicas Slack API