Create a workspace

Create a new workspace with the given name, on the chosen branch or commit. If neither is specified, the default branch is used. If a commit is specified, the workspace will be created on that commit, in a “detached” state, meaning it will not be associated with any branch and new commits cannot be published by it.

POST /repos/{repo_id}/workspaces

Create a workspace

cURL

curl --request POST \
  --url https://api.diversion.dev/v0/repos/{repo_id}/workspaces \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "branch_id": "<string>",
  "name": "<string>",
  "commit_id": "example_id"
}
'

201

{
  "id": "example_id"
}

Authorizations

Authorization · string · header · required

This API uses OAuth 2 with the implicit grant flow

Path Parameters

repo_id · string · required

The repo ID of the repository. Repo name can be used instead of the ID, but usage of ID for permanent linking and API requests is preferred.

Required string length: 3 - 128

Example:

"example_id"

Body

application/json

branch_id · string

name · string

commit_id · string

Required string length: 3 - 128

Example:

"example_id"

Response

201

application/json

Resource created

id · string · required

The id of the newly created resource

Example:

"example_id"