ASassemble

Open a session

Create or find an owner's session by name, then prepare its VM and filesystem. Reopening the same name reuses its identity. Selecting a different image for an existing name fails.

post/v1/sessions

Request

  • Base URL
    https://assemble-vms-api.fly.dev
  • URL
    https://assemble-vms-api.fly.dev/v1/sessions
  • Auth
    HTTP bearer

Request body

namestring required

Example request

{
  "name": "my-agent-project"
}

Response

Session ready for work.

idstring uuid required
namestring required
state'starting' | 'running' | 'paused' | 'stopped' | 'error' | 'deleting' required
rootDirectorystring required

Persistent project directory used by file operations and the default working directory for managed commands.

homeDirectorystring required

VM-local HOME for managed commands. Raw SSH uses the image login home unless the user explicitly exports this value.

createdAtstring date-time required
updatedAtstring date-time required

Example response

{
  "rootDirectory": "/workspace"
}

Changes

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