Home / Servers / DigitalOcean API / harness_create_session
CreateSession provisions a sandbox and starts a Harness Runtime session.
An MCP tool from the DigitalOcean API server, hosted on mcp.hjlabs.in.
CreateSession provisions a sandbox and starts a Harness Runtime session. Returns once the session row is allocated. Sandbox boot completes asynchronously. Two mutually exclusive request forms are selected by Content-Type (same contract as harness-api… [POST /v2/agents/sessions]
Name on the gateway: digitalocean_api__harness_create_session · may change things.
Parameters
| Name | Type | Description |
|---|---|---|
openai_session_id | string | OpenAI Agents API session id (sess_…) for adapter: codex-agentapi. doctl… |
resume_on_topoff | boolean | Opt the new session in to automatic resumption when the team's prepayment… |
name required | string | Session name, independent of the config name. Must satisfy the existing… |
config_id required | string | |
body_resume_on_topoff | boolean | Opt the new session in to automatic resumption when the team's prepayment… |
region | string | Optional placement check, not a placement choice: the session is always… |
workspace_id | string | Optional persistent workspace to attach at create; its files are mounted at… |
How to call it
Through the Smart Gateway, any client can run it by name with call_tool, or let the gateway find it with search_tools:
{
"name": "digitalocean_api__harness_create_session",
"arguments": {
"name": "…",
"config_id": "…"
}
}Or connect the DigitalOcean API server directly, which lists 874 tools including this one:
claude mcp add --transport http hj-digitalocean-api https://mcp.hjlabs.in/mcp/digitalocean-api \
--header "Authorization: Bearer YOUR_API_KEY"Try asking
Use the createsession provisions a sandbox and starts a harness runtime session. tool with openai_session_id set to ….