Skip to main content
POST
Switch to a workspace

Authorizations

Authorization
string
header
required

A Cool Computers API key, user access token, or claimed agent access token in the Authorization header. Follow https://www.cool.computer/auth.md for agent registration and https://www.cool.computer/authentication.md for direct user credentials.

Body

application/json
repo
string
required

owner/name of a repository a connected GitHub installation can access.

branch
string
required
create
boolean

Create the branch when it does not exist.

from
string

Base branch for a created branch.

Response

The workspace and its computer.

repo
string
required
branch
string
required
workspace_identity
string
required
action
string
required
branch_outcome
string
required
computer
object
required
permission_preflight
object
required
pull_requests
object
required