EndpointsWorkspaces

Call a workspace

POST/v2/workspaces/{workspace_id}/ops

Relays one operation envelope to the workspace's bridge and returns its reply unchanged: status, media type and body are the bridge's, marked by X-Workspace-Response: bridge. A text/event-stream reply streams until the bridge ends it. Platform refusals carry a typed kind and never that header: 404 unknown_workspace, 410 workspace_retired, 403 not the owner, 409 legacy_backend, 503 waking (retry the same op_id after Retry-After), 409 paused, 503 starting, 503 unavailable, 502 unavailable transport, 413 too_large for a non-stream reply over 1 MiB.

Authorization

BearerAuth
AuthorizationBearer <token>

Bearer token issued by Softmax

In: header

Path Parameters

workspace_id*Workspace Id

The workspace, as GET /v2/hermes reports its provisioning_id.

Formatuuid

Request Body

application/json

op_id*Op Id

Client-minted operation identity; the bridge passes it to the runtime as its idempotency key.

Formatuuid
name*Name

Operation name the bridge dispatches, such as session.send. The platform never interprets it.

Match^[a-z][a-z0-9_]*(\.[a-z][a-z0-9_]*){1,2}$
Lengthlength <= 80
args?

Operation arguments, at most 256 KiB serialized. The bridge validates them.

curl -X POST "https://softmax.com/api/observatory/v2/workspaces/497f6eca-6276-4993-bfeb-53cbbbba6f08/ops" \  -H "Content-Type: application/json" \  -d '{    "op_id": "5bb21562-136b-4a39-ab1f-f1b05cf1a53e",    "name": "string"  }'
null