Organizations

Create a single-use benchmark workspace

Creates an empty workspace for one trial, owned by the caller, with one scoped key. The parent pays for its usage: the workspace budget (rcus) is held on the parent's wallet and settled for actual consumption after retirement; runs use the parent's connected provider accounts. It admits exactly one Session, created with mode ephemeral, and is retired at expiry or by the retire operation.

<sub>Scope: org:write</sub>

post/v3/organizations/{orgId}/ephemeral-workspaces

Request

  • Base URL: https://api.reasonmachines.com
  • URL: https://api.reasonmachines.com/v3/organizations/{orgId}/ephemeral-workspaces
  • Auth: HTTP bearer

Request body

referencestring required

Caller trial identifier. The same request replays the same workspace and key; a different request with this reference conflicts.

ttl_minutesinteger

Lifetime before the workspace is retired automatically. Defaults to 240.

rcusstring

Workspace budget held on the parent's wallet and charged for actual use after retirement. Decimal string, defaults to 30, maximum 300; 0 runs only on the parent's connected provider accounts (BYOK).

Response

Replayed an identical request.

organization_idstring uuid required
parent_organization_idstring uuid required
referencestring required
expires_atstring required
retired_atstring nullable required
api_keystring required

Key for the new workspace only. Scopes: run, sessions:read, devices:read, devices:write, devices:use, deployment:read.

Changes

No recorded changes to this operation across all 1 revision of this API.